5 Interface net.connman.Service
6 Object path [variable prefix]/{service0,service1,...}
8 Methods dict GetProperties() [deprecated]
10 Returns properties for the service object. See
11 the properties section for available properties.
13 Usage of this method is highly discouraged. Use
14 the Manager.GetServices() method instead.
16 Possible Errors: [service].Error.InvalidArguments
18 void SetProperty(string name, variant value)
20 Changes the value of the specified property. Only
21 properties that are listed as read-write are
22 changeable. On success a PropertyChanged signal
25 Properties cannot be set for hidden WiFi service
26 entries or provisioned services.
28 Possible Errors: [service].Error.InvalidArguments
29 [service].Error.InvalidProperty
31 void ClearProperty(string name)
33 Clears the value of the specified property. Only
34 the readonly Error property can be cleared using
35 this method call. When cleared the service is reset
38 Possible Errors: [service].Error.InvalidProperty
42 Connect this service. It will attempt to connect
43 WiFi or Bluetooth services.
45 For Ethernet devices this method can only be used
46 if it has previously been disconnected. Otherwise
47 the plugging of a cable will trigger connecting
48 automatically. If no cable is plugged in this method
51 This method call will only return in case of an
52 error or when the service is fully connected. So
53 setting a longer D-Bus timeout might be a really
56 Calling Connect() on a hidden WiFi service entry will
57 query the missing SSID via the Agent API causing a
58 WiFi service with the given SSID to be scanned,
59 created and connected.
61 Possible Errors: [service].Error.InvalidArguments
65 Disconnect this service. If the service is not
66 connected an error message will be generated.
68 On Ethernet devices this will disconnect the IP
69 details from the service. It will not magically
70 unplug the cable. When no cable is plugged in this
73 This method can also be used to abort a previous
74 connection attempt via the Connect method.
76 Hidden WiFi service entries cannot be disconnected
77 as they always stay in idle state.
79 Possible Errors: [service].Error.InvalidArguments
83 A successfully connected service with Favorite=true
84 can be removed this way. If it is connected, it will
85 be automatically disconnected first.
87 If the service requires a passphrase it will be
88 cleared and forgotten when removing.
90 This is similar to setting the Favorite property
91 to false, but that is currently not supported.
93 In the case a connection attempt failed and the
94 service is in the state "failure", "idle" or
95 "disconnect", this method can also be used
98 Calling this method on Ethernet devices, hidden WiFi
99 services or provisioned services will cause an error
100 message. It is not possible to remove these kind of
103 Possible Errors: [service].Error.InvalidArguments
105 void MoveBefore(object service)
107 If a service has been used before, this allows a
108 reorder of the favorite services.
110 Possible Errors: [service].Error.InvalidArguments
112 void MoveAfter(object service)
114 If a service has been used before, this allows a
115 reorder of the favorite services.
117 Possible Errors: [service].Error.InvalidArguments
119 void ResetCounters() [experimental]
121 Reset the counter statistics.
123 Possible Errors: None
125 Signals PropertyChanged(string name, variant value)
127 This signal indicates a changed value of the given
130 Properties string State [readonly]
132 The service state information.
134 Valid states are "idle", "failure", "association",
135 "configuration", "ready", "disconnect" and "online".
137 The "ready" state signals a successfully
138 connected device. "online" signals that an
139 Internet connection is available and has been
142 See doc/overview-api.txt for more information about
145 string Error [readonly]
147 The service error status details.
149 When error occur during connection or disconnection
150 the detailed information is represented in this
151 property to help the user interface to present the
152 user with alternate options.
154 This property is only valid when the service is in
155 the "failure" state. Otherwise it might be empty or
158 Currently defined error codes are: "out-of-range",
159 "pin-missing", "dhcp-failed", "connect-failed",
160 "login-failed", "auth-failed" and "invalid-key".
162 string Name [readonly]
164 The service name (for example "Wireless" etc.)
166 This name can be used for directly displaying it in
167 the application. It has pure informational purpose
168 and no attempt should be made to translate it.
170 For Ethernet devices and hidden WiFi networks this
171 property is not present.
173 string Type [readonly]
175 The service type (for example "ethernet", "wifi" etc.)
177 This information should only be used to determine
178 advanced properties or showing the correct icon
181 Together with a missing Name property, this can
182 be used to identify hidden WiFi networks.
184 array{string} Security [readonly]
186 If the service type is WiFi, then this property is
187 present and contains the list of security methods
188 or key management settings.
190 Possible values are "none", "wep", "psk", "ieee8021x"
193 This property might be only present for WiFi
196 uint8 Strength [readonly]
198 Indicates the signal strength of the service. This
199 is a normalized value between 0 and 100.
201 This property will not be present for Ethernet
204 boolean Favorite [readonly]
206 Will be true if a cable is plugged in or the user
207 selected and successfully connected to this service.
209 This value is automatically changed and to revert
210 it back to false the Remove() method needs to be
213 boolean Immutable [readonly]
215 This value will be set to true if the service is
216 configured externally via a configuration file.
218 The only valid operations are Connect(), Disconnect()
219 and changing the AutoConnect property. The Remove()
220 method will result in an error.
222 boolean AutoConnect [readwrite]
224 If set to true, this service will auto-connect
225 when no other connection is available.
227 The service won't auto-connect while roaming.
229 For favorite services it is possible to change
230 this value to prevent or permit automatic
233 boolean Roaming [readonly]
235 This property indicates if this service is roaming.
237 In the case of Cellular services this normally
238 indicates connections to a foreign provider when
241 array{string} Nameservers [readonly]
243 The list of currently active nameservers for this
244 service. If the server is not in READY or ONLINE
245 state than this list will be empty.
247 Global nameservers are automatically added to this
248 list. The array represents a sorted list of the
249 current nameservers. The first one has the highest
250 priority and is used by default.
252 When using DHCP this array represents the nameservers
253 provided by the network. In case of manual settings,
254 the ones from Nameservers.Configuration are used.
256 array{string} Nameservers.Configuration [readwrite]
258 The list of manually configured domain name
259 servers. Some cellular networks don't provide
260 correct name servers and this allows for an
263 This array is sorted by priority and the first
264 entry in the list represents the nameserver with
265 the highest priority.
267 When using manual configuration and no global
268 nameservers are configured, then it is useful
269 to configure this setting.
271 Changes to the domain name servers can be done
272 at any time. It will not cause a disconnect of
273 the service. However there might be small window
274 where name resolution might fail.
276 array{string} Timeservers [readonly]
278 The list of currently active timeservers for this
279 service. If the server is not in READY or ONLINE
280 state than this list will be empty.
282 array{string} Timeservers.Configuration [readwrite]
284 The list of manually configured time servers.
286 The first entry in the list represents the
287 timeserver with the highest priority.
289 When using manual configuration this setting
290 is useful to override all the other timeserver
291 settings. This is service specific, hence only
292 the values for the default service are used.
294 Changes to this property will result in restart
297 array{string} Domains [readonly]
299 The list of currently used search domains taken
300 from Domains.Configurations if set, otherwise a
301 domain name if provided by DHCP or VPNs.
303 array{string} Domains.Configuration [readwrite]
305 The list of manually configured search domains.
309 string Method [readonly]
311 Possible values are "dhcp", "manual", "auto"
314 It could be "auto" in case address was got
315 through IPv4LL after DHCP failed. In this
316 case also IPv4.Configuration will become
317 "auto" to allow user to ask for a DHCP
320 The value "fixed" indicates an IP address
321 that can not be modified. For example
322 cellular networks return fixed information.
324 string Address [readonly]
326 The current configured IPv4 address.
328 string Netmask [readonly]
330 The current configured IPv4 netmask.
332 string Gateway [readonly]
334 The current configured IPv4 gateway.
336 dict IPv4.Configuration [readwrite]
338 Same values as IPv4 property. The IPv4 represents
339 the actual system configuration while this allows
342 Changing these settings will cause a state change
343 of the service. The service will become unavailable
344 until the new configuration has been successfully
349 string Method [readonly]
351 Possible values are "auto", "manual", "6to4"
354 The value "fixed" indicates an IP address
355 that can not be modified. For example
356 cellular networks return fixed information.
357 The value "6to4" is returned if 6to4 tunnel
358 is created by connman. The tunnel can only be
359 created if method was set to "auto" by the
360 user. User cannot set the method to "6to4".
362 string Address [readonly]
364 The current configured IPv6 address.
366 uint8 PrefixLength [readonly]
368 The prefix length of the IPv6 address.
370 string Gateway [readonly]
372 The current configured IPv6 gateway.
374 string Privacy [readonly]
376 Enable or disable IPv6 privacy extension
377 that is described in RFC 4941. The value
378 has only meaning if Method is set to "auto".
380 Value "disabled" means that privacy extension
381 is disabled and normal autoconf addresses are
384 Value "enabled" means that privacy extension is
385 enabled and system prefers to use public
386 addresses over temporary addresses.
388 Value "prefered" means that privacy extension is
389 enabled and system prefers temporary addresses
390 over public addresses.
392 Default value is "disabled".
394 dict IPv6.Configuration [readwrite]
396 Same values as IPv6 property. The IPv6 represents
397 the actual system configuration while this allows
400 Changing these settings will cause a state change
401 of the service. The service will become unavailable
402 until the new configuration has been successfully
405 dict Proxy [readonly]
407 string Method [readonly]
409 Possible values are "direct", "auto" and
412 In case of "auto" method, the URL file can be
413 provided unless you want to let DHCP/WPAD
414 auto-discover to be tried. In such case if DHCP
415 and WPAD auto-discover methods fails then
416 method will be "direct".
418 In case of "direct" no additional information
419 are provided. For the "manual" method the
420 Servers have to be set, Excludes is optional.
422 string URL [readonly]
424 Automatic proxy configuration URL. Used by
427 array{string} Servers [readonly]
429 Used when "manual" method is set.
431 List of proxy URIs. The URI without a protocol
432 will be interpreted as the generic proxy URI.
433 All others will target a specific protocol and
436 Example for generic proxy server entry would
437 be like this: "server.example.com:911".
439 array{string} Excludes [readonly]
441 Used when "manual" method is set.
443 List of hosts which can be accessed directly.
445 dict Proxy.Configuration [readwrite]
447 Same values as Proxy property. The Proxy represents
448 the actual system configuration while this allows
451 If "auto" method is set with an empty URL, then
452 DHCP/WPAD auto-discover will be tried. Otherwise the
453 specified URL will be used.
455 dict Provider [readonly]
457 string Host [readonly]
461 string Domain [readonly]
465 string Name [readonly]
469 string Type [readonly]
473 dict Ethernet [readonly]
475 string Method [readonly]
477 Possible values are "auto" and "manual".
479 string Interface [readonly]
481 Interface name (for example eth0).
483 string Address [readonly]
485 Ethernet device address (MAC address).
487 uint16 MTU [readonly]
489 The Ethernet MTU (default is 1500).
491 uint16 Speed [readonly] [deprecated]
493 Selected speed of the line.
495 This information is not available.
497 string Duplex [readonly] [deprecated]
499 Selected duplex settings of the line.
500 Possible values are "half" and "full".
502 This information is not available.