- 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.
-
- uint32 IdleTimeout [readwrite]
-
- If the system is idle for given period then it should
- go offline.
-
- If the timeout is 0, this feature is disabled. If
- different values are provided by several session object
- the longest interval is taken as timeout value.
-
- boolean EmergencyCall [readwrite]
-
- Boolean representing the emergency mode of the
- modem. The Emergency is true if an emergency call or
- related operation is currently active.
-
- If the emergency application sets this setting to true
- all other session will be informed about the emergency
- situation with setting it also to true. Only the
- emergency application can set back to false.
-
- As long the EmergencyCall is true no new session can
- be created.
-
- Only one application is supposed to write this setting
- and therefore it will be protected by additional
- PolicyKit rule so that only the emergency application
- can write.
-
- The emergency application is expected to call Connect()
- after setting this setting true. If the emergency
- situation is over the application should call
- Disconnect() and also set the EmergencyCall to false
- afterward.
-
- Note only services matching the AllowedBearers rule
- will be considered.
-
- string RoamingPolicy [readwrite]
-
- The allowed roaming behavior.
-
- Valid policies are "national", "international",
- "default", "always" and "forbidden".
-
- "national" allows roaming within a country.
- "international" allows roaming in a country and
- between countries.
-
- "default" is used to tell the Session to use
- the global roaming setting.
-
- "always" will overwrite the default "forbidden"
- value which is useful for emergency application.
- This value will be protected by additional PolicyKit
- rule.
-
- Default value is "forbidden".
-
- string Interface [readonly]
-
- Interface name used by the service object to connect.
- This name can be used for SO_BINDTODEVICE in the
- application.