- are: <code>VOID</code>, <code>BACKOFF</code>,
- <code>CONNECTING</code>, <code>ACTIVE</code>, and
- <code>IDLE</code>.</dd>
- </dl>
- <dl>
- <dt><code>time_in_state</code></dt>
- <dd>Seconds since connecting to (if currently connected) or
- disconnecting from (if currently disconnected) this
- controller.</dd>
+ are: <code>VOID</code> (connection is disabled),
+ <code>BACKOFF</code> (attempting to reconnect at an increasing
+ period), <code>CONNECTING</code> (attempting to connect),
+ <code>ACTIVE</code> (connected, remote host responsive), and
+ <code>IDLE</code> (remote host idle, sending keep-alive). These
+ values may change in the future. They are provided only for human
+ consumption.</dd>
+ <dt><code>sec_since_connect</code></dt>
+ <dd>The amount of time since this controller last successfully
+ connected to the switch (in seconds). Value is empty if controller
+ has never successfully connected.</dd>
+ <dt><code>sec_since_disconnect</code></dt>
+ <dd>The amount of time since this controller last disconnected from
+ the switch (in seconds). Value is empty if controller has never
+ disconnected.</dd>