Possible Errors: [service].Error.InvalidArguments
[service].Error.InvalidProperty
- string GetState()
+ array{object,dict} GetTechnologies()
- Return global connection state of a system. The
- same value is return via the State property.
-
- Possible Errors: [service].Error.InvalidArguments
-
- void RequestScan(string type)
-
- Request to trigger a scan for the specified
- technology. The empty string "" triggers scanning
- on all technologies.
-
- Possible Errors: [service].Error.InvalidArguments
-
- void EnableTechnology(string type)
-
- Enable specified type of technologies.
-
- Possible Errors: [service].Error.InvalidArguments
-
- void DisableTechnology(string type)
-
- Disable specified type of technologies.
+ Returns a list of tuples with technology object
+ path and dictionary of technology properties.
Possible Errors: [service].Error.InvalidArguments
Possible Errors: [service].Error.InvalidArguments
- object LookupService(string pattern)
-
- Lookup a service matching the specific pattern.
-
- Examples are interface names like "eth0", "wlan0"
- etc. or service names like "hotspot" etc.
-
- In case of multiple services match the the pattern
- an error is returned.
-
- Possible Errors: [service].Error.InvalidArguments
- [service].Error.NotUnique
- [service].Error.NotFound
-
- object ConnectService(dict network)
-
- Connect to a network specified by the given
- properties.
-
- For connecting to a hidden WiFi network for example
- it is required that Type = "wifi" and the SSID
- properties are provided.
-
- When successful this method will return object
- path of the service object.
-
- This method can also be used to connect to an
- already existing service. It works exactly the
- same as executing the Connect method from the
- service interface.
-
- This method call will only return in case of an
- error or when the service is fully connected. So
- setting a longer D-Bus timeout might be a really
- good idea.
-
- Possible Errors: [service].Error.InvalidArguments
-
- void ProvisionService(string configuration)
-
- Provide a configuration for services.
-
- Service configuration is provided as a single string
- that follows the same format as configuration files,
- see config-format.txt. An exception to this format
- is that only one service can be provisioned per call.
-
- Possible Errors: [service].Error.InvalidArguments
-
object ConnectProvider(dict provider)
Connect to a VPN specified by the given provider
setting a longer D-Bus timeout might be a really
good idea.
+ When 'SessionMode' property is enabled, this method
+ call is disallowed.
+
Possible Errors: [service].Error.InvalidArguments
void RegisterAgent(object path)
Possible Errors: [service].Error.InvalidArguments
- void RegisterCounter(object path, uint32 accuracy, uint32 period)
+ void RegisterCounter(object path, uint32 accuracy, uint32 period) [experimental]
Register a new counter for user notifications.
Possible Errors: [service].Error.InvalidArguments
- void UnregisterCounter(object path)
+ void UnregisterCounter(object path) [experimental]
Unregister an existing counter.
Possible Errors: [service].Error.InvalidArguments
- object CreateSession(dict settings, object notifier)
+ object CreateSession(dict settings, object notifier) [experimental]
Create a new session for the application. Every
application can create multiple session with
Every application should at least create one session
to inform about its requirements and it purpose.
- void DestroySession(object session)
+ void DestroySession(object session) [experimental]
- Remove the previously created session. The notifier
- will be informed via its release method.
+ Remove the previously created session.
If an application exits unexpectatly the session
will be automatically destroyed.
- StateChanged(string state)
+ object path, dict, fd RequestPrivateNetwork(dict options)
+ [experimental]
- This signal is similar to the PropertyChanged signal
- for the State property.
+ Request a new Private Network, which includes the
+ creation of a tun/tap interface, and IP
+ configuration, NAT and IP forwarding on that
+ interface.
+ An object path, a dictionnary and a file descriptor
+ with IP settings are returned.
- It exists for application state only care about the
- current state and so can avoid to be woken up when
- other details changes.
+ Possible Errors: [service].Error.InvalidArguments
+ [service].Error.NotSupported
-Properties string State [readonly]
+ void ReleasePrivateNetwork(object path) [experimental]
- The global connection state of a system. Possible
- values are "online" if at least one connection exists
- and "offline" if no device is connected.
+ Releases a private network.
- In certain situations the state might change to
- the value "connected". This can only be seen if
- previously no connection was present.
+ Possible Errors: [service].Error.InvalidArguments
+
+Signals TechnologyAdded(object path, dict properties)
+
+ Signal that is sent when a new technology is added.
+
+ It contains the object path of the technology and
+ also its properties.
- array{string} AvailableTechnologies [readonly]
+ TechnologyRemoved(object path)
- The list of available technologies. The strings
- are the same as the ones from the service types.
+ Signal that is sent when a modem has been removed.
- array{string} EnabledTechnologies [readonly]
+ The object path is no longer accessible after this
+ signal and only emitted for reference.
- The list of enabled technologies. The strings
- are the same as the ones from the service types.
+ ServicesAdded(array{object, dict})
- array{string} ConnectedTechnologies [readonly]
+ List of service that have been added. The array
+ is a list of services that is sorted with existing
+ services containing an empty dictionary and new
+ services containing the properties.
- The list of connected technologies. The strings
- are the same as the ones from the service type.
+ This signal will only inform about added services
+ and in case that services get added and removed at
+ the same time, a ServicesRemoved signal will be
+ sent first.
- string DefaultTechnology [readonly]
+ ServicesRemoved(array{object})
- The current connected technology which holds the
- default route.
+ Signals a list of services that are no longer valid.
+
+ The object paths are no longer accessible after
+ this signal and only emitted for reference.
+
+ PropertyChanged(string name, variant value)
+
+ This signal indicates a changed value of the given
+ property.
+
+Properties string State [readonly]
+
+ The global connection state of a system. Possible
+ values are "online" if at least one connection exists
+ and "offline" if no device is connected.
+
+ In certain situations the state might change to
+ the value "connected". This can only be seen if
+ previously no connection was present.
boolean OfflineMode [readwrite]
the limited usage of WiFi or Bluetooth devices might
be allowed in some situations.
- object ActiveProfile [readwrite]
-
- Object path of the current active profile.
-
- array{object} Technologies [readonly]
-
- List of technology object paths.
-
- array{object} Services [readonly]
-
- List of service object paths. The list is sorted
- internally to have the service with the default
- route always first and then the favorite services
- followed by scan results.
-
- This list represents the available services for the
- current selected profile. If the profile gets changed
- then this list will be updated.
-
- The same list is available via the profile object
- itself. It is just provided here for convenience of
- applications only dealing with the current active
- profile.
-
- boolean SessionMode [readwrite]
+ boolean SessionMode [readwrite] [experminental]
This disables the auto connect feature. It should be
- enabled when the Session API is used.
+ enabled when the Session API is used. When SessionMode
+ is enabled, 'ConnectService' and 'ConnectProvider'
+ method calls are disallowed.
The default value is false.