5 Interface net.connman.Manager
8 Methods dict GetProperties()
10 Returns all global system properties. See the
11 properties section for available properties.
13 Possible Errors: [service].Error.InvalidArguments
15 void SetProperty(string name, variant value)
17 Changes the value of the specified property. Only
18 properties that are listed as read-write are
19 changeable. On success a PropertyChanged signal
22 Possible Errors: [service].Error.InvalidArguments
23 [service].Error.InvalidProperty
27 Return global connection state of a system. The
28 same value is return via the State property.
30 Possible Errors: [service].Error.InvalidArguments
32 void RequestScan(string type)
34 Request to trigger a scan for the specified
35 technology. The empty string "" triggers scanning
38 Possible Errors: [service].Error.InvalidArguments
40 void EnableTechnology(string type)
42 Enable specified type of technologies.
44 Possible Errors: [service].Error.InvalidArguments
46 void DisableTechnology(string type)
48 Disable specified type of technologies.
50 Possible Errors: [service].Error.InvalidArguments
52 array{object,dict} GetServices()
54 Returns a sorted list of tuples with service
55 object path and dictionary of service properties.
57 This list will not contain sensitive information
60 Possible Errors: [service].Error.InvalidArguments
62 object LookupService(string pattern)
64 Lookup a service matching the specific pattern.
66 Examples are interface names like "eth0", "wlan0"
67 etc. or service names like "hotspot" etc.
69 In case of multiple services match the the pattern
72 Possible Errors: [service].Error.InvalidArguments
73 [service].Error.NotUnique
74 [service].Error.NotFound
76 object ConnectService(dict network)
78 Connect to a network specified by the given
81 For connecting to a hidden WiFi network for example
82 it is required that Type = "wifi" and the SSID
83 properties are provided.
85 When successful this method will return object
86 path of the service object.
88 This method can also be used to connect to an
89 already existing service. It works exactly the
90 same as executing the Connect method from the
93 This method call will only return in case of an
94 error or when the service is fully connected. So
95 setting a longer D-Bus timeout might be a really
98 Possible Errors: [service].Error.InvalidArguments
100 void ProvisionService(string configuration)
102 Provide a configuration for services.
104 Service configuration is provided as a single string
105 that follows the same format as configuration files,
106 see config-format.txt. An exception to this format
107 is that only one service can be provisioned per call.
109 Possible Errors: [service].Error.InvalidArguments
111 object ConnectProvider(dict provider)
113 Connect to a VPN specified by the given provider
116 When successful this method will return the object
117 path of the VPN service object.
119 This method can also be used to connect to an
120 already existing VPN.
122 This method call will only return in case of an
123 error or when the service is fully connected. So
124 setting a longer D-Bus timeout might be a really
127 Possible Errors: [service].Error.InvalidArguments
129 void RegisterAgent(object path)
131 Register new agent for handling user requests.
133 Possible Errors: [service].Error.InvalidArguments
135 void UnregisterAgent(object path)
137 Unregister an existing agent.
139 Possible Errors: [service].Error.InvalidArguments
141 void RegisterCounter(object path, uint32 accuracy, uint32 period)
143 Register a new counter for user notifications.
145 The accuracy is specified in kilo-bytes and defines
146 a threshold for counter updates. Together with the
147 period value it defines how often user space needs
148 to be updated. The period value is in seconds.
150 This interface is not meant for time tracking. If
151 the time needs to be tracked down to the second, it
152 is better to have a real timer running inside the
153 application than using this interface.
155 Also getting notified for every kilo-byte is a bad
156 choice (even if the interface supports it). Something
157 like 10 kilo-byte units or better 1 mega-byte seems
158 to be a lot more reasonable and better for the user.
160 Possible Errors: [service].Error.InvalidArguments
162 void UnregisterCounter(object path)
164 Unregister an existing counter.
166 Possible Errors: [service].Error.InvalidArguments
168 object CreateSession(dict settings, object notifier)
170 Create a new session for the application. Every
171 application can create multiple session with
172 different settings. The settings are described
173 as part of the session interface.
175 The notifier allows asynchronous notification about
176 session specific changes. These changes can be
177 for online/offline state or IP address changes or
178 similar things the application is required to
181 Every application should at least create one session
182 to inform about its requirements and it purpose.
184 void DestroySession(object session)
186 Remove the previously created session. The notifier
187 will be informed via its release method.
189 If an application exits unexpectatly the session
190 will be automatically destroyed.
192 StateChanged(string state)
194 This signal is similar to the PropertyChanged signal
195 for the State property.
197 It exists for application state only care about the
198 current state and so can avoid to be woken up when
199 other details changes.
201 Properties string State [readonly]
203 The global connection state of a system. Possible
204 values are "online" if at least one connection exists
205 and "offline" if no device is connected.
207 In certain situations the state might change to
208 the value "connected". This can only be seen if
209 previously no connection was present.
211 array{string} AvailableTechnologies [readonly]
213 The list of available technologies. The strings
214 are the same as the ones from the service types.
216 array{string} EnabledTechnologies [readonly]
218 The list of enabled technologies. The strings
219 are the same as the ones from the service types.
221 array{string} ConnectedTechnologies [readonly]
223 The list of connected technologies. The strings
224 are the same as the ones from the service type.
226 string DefaultTechnology [readonly]
228 The current connected technology which holds the
231 boolean OfflineMode [readwrite]
233 The offline mode indicates the global setting for
234 switching all radios on or off. Changing offline mode
235 to true results in powering down all devices. When
236 leaving offline mode the individual policy of each
237 device decides to switch the radio back on or not.
239 During offline mode, it is still possible to switch
240 certain technologies manually back on. For example
241 the limited usage of WiFi or Bluetooth devices might
242 be allowed in some situations.
244 object ActiveProfile [readwrite]
246 Object path of the current active profile.
248 array{object} Technologies [readonly]
250 List of technology object paths.
252 array{object} Services [readonly]
254 List of service object paths. The list is sorted
255 internally to have the service with the default
256 route always first and then the favorite services
257 followed by scan results.
259 This list represents the available services for the
260 current selected profile. If the profile gets changed
261 then this list will be updated.
263 The same list is available via the profile object
264 itself. It is just provided here for convenience of
265 applications only dealing with the current active
268 boolean SessionMode [readwrite]
270 This disables the auto connect feature. It should be
271 enabled when the Session API is used.
273 The default value is false.