| tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 1 | package org.onlab.onos.net.host; |
| 2 | |
| tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 3 | import org.onlab.onos.net.Host; |
| tom | c1a38d3 | 2014-08-25 23:01:32 -0700 | [diff] [blame] | 4 | import org.onlab.onos.net.provider.Provider; |
| tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 5 | |
| 6 | /** |
| 7 | * Provider of information about hosts and their location on the network. |
| 8 | */ |
| 9 | public interface HostProvider extends Provider { |
| tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 10 | |
| tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 11 | /** |
| 12 | * Triggers an asynchronous probe of the specified host, intended to |
| 13 | * determine whether the host is present or not. An indirect result of this |
| tom | 326b71a | 2014-09-09 14:49:17 -0700 | [diff] [blame] | 14 | * should be invocation of {@link org.onlab.onos.net.host.HostProviderService#hostDetected} |
| 15 | * or {@link org.onlab.onos.net.host.HostProviderService#hostVanished} |
| tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 16 | * at some later point in time. |
| 17 | * |
| 18 | * @param host host to probe |
| 19 | */ |
| 20 | void triggerProbe(Host host); |
| 21 | |
| tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 22 | } |