From 5942e130adf76f71bbf84ff61b9e18181d44a121 Mon Sep 17 00:00:00 2001 From: Daniel Wagner Date: Mon, 13 Aug 2012 10:40:19 +0200 Subject: session: Remove PeriodicConnect documentation The idea was to let ConnMan know and optimize the connection scheduling. Doing this per Session is a bit over-engineered. The only use cases that have come up so far was for things like an email client checking for new message. Past experience showed that this kind of interface lead easily to live locks. If there is need for such a feature, doing it on a per technology would make more sense. For the time beeing it will be removed. Later it could still be added to the Technology API. If an application still wants to have a connection on regular basis it can call the Session Connnect() method. ConnMan is still able to defer any connection request. --- doc/session-api.txt | 27 --------------------------- 1 file changed, 27 deletions(-) (limited to 'doc') diff --git a/doc/session-api.txt b/doc/session-api.txt index c870a807..9a8e40d1 100644 --- a/doc/session-api.txt +++ b/doc/session-api.txt @@ -217,33 +217,6 @@ Settings string Bearer [readonly] If the system is not online yet this value is ignored. - uint32 PeriodicConnect [readwrite] - - Indicate that a periodic connection attempt every - n minutes should be made. The minutes value is a - suggestion when to connection. There is no guarantee - that it will be made or will succeed. - - A value of 0 disable this feature. - - This feature is interesting for applications that - wanna check status on a regular interval. And instead - of the application waking up and trying to connect, - this can be centralized nicely and multiple wakeups - avoided in case no connection is available. - - An example application would be an email client that - wants to check for new emails every 10 minutes. - - On purpose the smallest setting is 1 minute here since - waking up more often and trying to set up a connection - seems rather pointless use case. - - If an interval step has passed this can be nicely - rescheduled when any connection matching the bearer - settings becomes available becomes available. Using - this feature it is also easy to avoid congestion. - boolean EmergencyCall [readwrite] Boolean representing the emergency mode of the -- cgit v1.2.3