diff options
Diffstat (limited to 'doc/manager-api.txt')
-rw-r--r-- | doc/manager-api.txt | 33 |
1 files changed, 17 insertions, 16 deletions
diff --git a/doc/manager-api.txt b/doc/manager-api.txt index 332f6cda..c92c2957 100644 --- a/doc/manager-api.txt +++ b/doc/manager-api.txt @@ -174,28 +174,29 @@ Methods dict GetProperties() Possible Errors: [service].Error.InvalidArguments - object RequestSession(string bearer) + object CreateSession(dict settings, object notifier) - Request a networking session. + Create a new session for the application. Every + application can create multiple session with + different settings. The settings are described + as part of the session interface. - If the bearer is an empty string the best available - service will be picked. + The notifier allows asynchronous notification about + session specific changes. These changes can be + for online/offline state or IP address changes or + similar things the application is required to + handle. - When successful this method will return the object - path of the corresponding service. - - Possible Errors: [service].Error.InvalidArguments + Every application should at least create one session + to inform about its requirements and it purpose. - void ReleaseSession() - - Release a networking session. - - Possible Errors: [service].Error.InvalidArguments + void DestroySession(object session) -Signals PropertyChanged(string name, variant value) + Remove the previously created session. The notifier + will be informed via its release method. - This signal indicates a changed value of the given - property. + If an application exits unexpectatly the session + will be automatically destroyed. StateChanged(string state) |