| 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; |
| 4 | import org.onlab.onos.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 | |
| 11 | // TODO: consider how dirty the triggerProbe gets; if it costs too much, let's drop it |
| 12 | |
| 13 | /** |
| 14 | * Triggers an asynchronous probe of the specified host, intended to |
| 15 | * determine whether the host is present or not. An indirect result of this |
| 16 | * should be invocation of {@link org.onlab.onos.net.host.HostProviderService#hostDetected(HostDescription)} or |
| 17 | * {@link org.onlab.onos.net.host.HostProviderService#hostNotDetected(HostDescription)} |
| 18 | * at some later point in time. |
| 19 | * |
| 20 | * @param host host to probe |
| 21 | */ |
| 22 | void triggerProbe(Host host); |
| 23 | |
| tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 24 | } |