From 1514d2251c724f4e402cfad2b811ff62552d8bbd Mon Sep 17 00:00:00 2001 From: Tomasz Bursztyka Date: Wed, 15 Feb 2012 10:19:46 +0200 Subject: [PATCH] doc: updated session api documentation --- doc/session-api.txt | 58 +++++++++++++++++++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 20 deletions(-) diff --git a/doc/session-api.txt b/doc/session-api.txt index 0bc93fc..e19c6bf 100644 --- a/doc/session-api.txt +++ b/doc/session-api.txt @@ -88,20 +88,42 @@ Settings string Bearer [readonly] This indicates the current bearer that is used for this session. Or an empty string if no bearer - is available. - - boolean Online [readonly] - - This indicates if the connection is online or - offline. - - This maps to the online service state. And it is - only valid for the selected bearer configuration. - Otherwise it will be reported as offline even if - the global state would be online. - - In addition the Online settings notification might - not happen right away. Notifications of online state + if available. + + string ConnectionType [readwrite] + + This is used to indicate which connection is requested + from the session. The state of the session will be + updated accordingly. Values can be nothing, 'local' or + 'internet'. + 'local' means the session requests to be connected, + but does not require specifically to be online. + Therefore State property will be set to 'connected' if + underlying service gets ready and/or online. + 'online' means the session requests to be connected, + and online. State property will never get 'connected' + but instead will switch to 'online' if underlying + service gets online. + No value means the session requests any kind of + connection and the state will be updated on all steps, + 'connected' and 'online'. This is the default value. + + boolean State [readonly] + + This indicates if the connection is disconnected, + connected or online. It is updated according to the + selected ConnectionType. The session will not be + in a useful shape (i.e.: providing a network connection + to the owner) until its State gets updated to connected + and/or online. + + This maps to the useful port of the service state. + And it is only valid for the selected bearer + configuration. Otherwise it will be reported as + disconnected even if connected services are present. + + In addition the State settings notification might + not happen right away. Notifications of this state can be delayed based on the speed of the bearer. It is done to avoid congestion on bearers like cellular etc. @@ -158,15 +180,11 @@ Settings string Bearer [readonly] dict IPv4 [readonly] - Current IPv4 configuration. This settings is only - valid when online is true as well. Otherwise an - empty dictionary is reported. + Current IPv4 configuration. dict IPv6 [readonly] - Current IPv6 configuration. This setting is only - valid when online is true as well. Otherwise an - empty dictionary is reported. + Current IPv6 configuration. boolean AvoidHandover [readwrite] -- 2.7.4