summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/overview-api.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/overview-api.txt b/doc/overview-api.txt
index afb996de..92aed886 100644
--- a/doc/overview-api.txt
+++ b/doc/overview-api.txt
@@ -262,6 +262,10 @@ The basic state of every service is "idle". This means that this service
is not in use at all at the moment. It also is not attempting to connect
or do anything else.
+With Ethernet services a special "carrier" state is available. It indicates
+that the cable has been plugged in. This state is only used when the device
+is from type Ethernet.
+
The "association" state indicates that this service tries to establish a
low-level connection to the network. For example associating/connecting
with a WiFi access point.
@@ -285,6 +289,14 @@ the "idle" state since the service is not connected.
+---------------+
| idle |<-------------------------------+
+---------------+ |
+ | | |
+ | +----------------------+ |
+ | | |
+ | V |
+ | +-------------+ |
+ +----------------------| carrier |<----+
+ | +-------------+ |
+ | |
| +-------------+ |
+----------------------| failure | |
| service.Connect() +-------------+ |