service: Simplify nameserver route adding and removing
[framework/connectivity/connman.git] / doc / technology-api.txt
1 Technology hierarchy
2 ====================
3
4 Service         net.connman
5 Interface       net.connman.Technology
6 Object path     [variable prefix]/{technology0,technology1,...}
7
8 Methods         dict GetProperties()  [deprecated]
9
10                         Returns properties for the technology object. See
11                         the properties section for available properties.
12
13                         Usage of this method is highly discouraged. Use
14                         the Manager.GetTechnologies() method instead.
15
16                         Possible Errors: [service].Error.InvalidArguments
17
18                 void SetProperty(string name, variant value)
19
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
23                         will be emitted.
24
25                         Possible Errors: [service].Error.InvalidArguments
26                                          [service].Error.InvalidProperty
27
28                 void Scan()
29
30                         Trigger a scan for this specific technology. The
31                         method call will return when a scan has been
32                         finished and results are available. So setting
33                         a longer D-Bus timeout might be a really good
34                         idea.
35
36                         Results will be signaled via the ServicesChanged
37                         signal from the manager interface.
38
39 Signals         PropertyChanged(string name, variant value)
40
41                         This signal indicates a changed value of the given
42                         property.
43
44 Properties      boolean Powered [readwrite]
45
46                         Boolean representing the power state of the
47                         technology. False means that the technology is
48                         off (and is available RF-Killed) while True means
49                         that the technology is enabled.
50
51                 boolean Connected [readonly]
52
53                         Boolean representing if a technolgy is connected.
54
55                         This is just a convience property for allowing the
56                         UI to easily show if this technolgy has an active
57                         connection or not.
58
59                         If this property is True it means that at least one
60                         service of this technology is in ready state.
61
62                 string Name [readonly]
63
64                         Name of this technology.
65
66                 string Type [readonly]
67
68                         The technology type (for example "ethernet" etc.)
69
70                         This information should only be used to determine
71                         advanced properties or showing the correct icon
72                         to the user.
73
74                 boolean Tethering [readwrite]
75
76                         This option allows to enable or disable the support
77                         for tethering. When tethering is enabled then the
78                         default service is bridged to all clients connected
79                         through the technology.
80
81                 string TetheringIdentifier [readwrite]
82
83                         The tethering broadcasted identifier.
84
85                         This property is only valid for the WiFi technology,
86                         and is then mapped to the WiFi AP SSID clients will
87                         have to join in order to gain internet connectivity.
88
89                 string TetheringPassphrase [readwrite]
90
91                         The tethering connection passphrase.
92
93                         This property is only valid for the WiFi technology,
94                         and is then mapped to the WPA pre-shared key clients
95                         will have to use in order to establish a connection.