Aaron Kruglikov
Committed by Gerrit Code Review

Disambiguation of the difference between reachability and availability.

Change-Id: Ie4c7468453d64a48a0bf712737f927f7086a5bc5
...@@ -50,6 +50,8 @@ public interface DeviceProvider extends Provider { ...@@ -50,6 +50,8 @@ public interface DeviceProvider extends Provider {
50 50
51 /** 51 /**
52 * Checks the reachability (connectivity) of a device from this provider. 52 * Checks the reachability (connectivity) of a device from this provider.
53 + * Reachability, unlike availability, denotes whether THIS particular node
54 + * can send messages and receive replies from the specified device.
53 * 55 *
54 * @param deviceId device identifier 56 * @param deviceId device identifier
55 * @return true if reachable, false otherwise 57 * @return true if reachable, false otherwise
......
...@@ -123,6 +123,10 @@ public interface DeviceService ...@@ -123,6 +123,10 @@ public interface DeviceService
123 123
124 /** 124 /**
125 * Indicates whether or not the device is presently online and available. 125 * Indicates whether or not the device is presently online and available.
126 + * Availability, unlike reachability, denotes whether ANY node in the
127 + * cluster can discover that this device is in an operational state,
128 + * this does not necessarily mean that there exists a node that can
129 + * control this device.
126 * 130 *
127 * @param deviceId device identifier 131 * @param deviceId device identifier
128 * @return true if the device is available 132 * @return true if the device is available
......