With the "configuration" state the service indicates that it is trying
to retrieve/configure IP settings.
-Some service might require special authentication procedure like a web based
-confirmation. The "login" should be used for this in the future. Currently
-this is not implemented.
-
The "ready" state signals a successful connected device. This doesn't mean
it has the default route, but basic IP operations will succeed.
V | |
+---------------+ | |
| configuration |-----------------+ |
- +---------------+ error | |
- | | |
- | success | |
- V | |
- +---------------+ +-------------+ |
- | ready |----------->| login | |
- +---------------+ +-------------+ |
- | | |
- | success | |
- | | |
- +---------------------------+ |
- | authentication |
+ +---------------+ error |
+ | |
+ | success |
+ V |
+ +---------------+ |
+ | ready | |
+ +---------------+ |
+ | |
+ | success |
+ | |
V |
+---------------+ |
| online |<----------------+ |
cases where networks are flaky or DHCP servers take a long time these
information are helpful for the user.
+Some services might require special authentication procedure like a web
+based confirmation. The LoginRequired property should be used to check
+for this.
+
Application basics
==================
The service state information.
Valid states are "idle", "failure", "association",
- "configuration" and "ready".
+ "configuration", "ready" and "online".
- Also "login" and "online" states are used. The
- state "online" signals that an Internet connection
- is available and has been verified.
+ The "ready" state signals a successfully
+ connected device. "online" signals that an
+ Internet connection is available and has been
+ verified.
string Error [readonly]
boolean LoginRequired [readonly]
This property indicates that an additional login
- step is needed before the connection establishment
- can proceed.
+ step, like web based authentication, is needed
+ before the connection establishment can proceed.
string Passphrase [readwrite]