Document generic Name, Available and Remember properties
[connman] / doc / network-api.txt
1 Network hierarchy
2 =================
3
4 Service         org.moblin.connman
5 Interface       org.moblin.connman.Network
6 Object path     [variable prefix]/{network0,network1,...}
7
8 Methods         dict GetProperties()
9
10                         Returns properties for the network object. See
11                         the properties section for available properties.
12
13                         Possible Errors: [service].Error.InvalidArguments
14
15                 void SetProperty(string name, variant value)
16
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
20                         will be emitted.
21
22                         Possible Errors: [service].Error.InvalidArguments
23                                          [service].Error.DoesNotExist
24
25 Signals         PropertyChanged(string name, variant value)
26
27                         This signal indicates a changed value of the given
28                         property.
29
30 Properties      string Name [readonly]
31
32                         The pretty/long version of the network name. For
33                         example in case of WiFi this should be the UTF-8
34                         valid version of the SSID.
35
36                 boolean Available [readonly]
37
38                         Indicates that this network is in range and
39                         ready to be used.
40
41                         The scanning process can change this property.
42
43                 boolean Remember [readwrite]
44
45                         Indicates that this network will be remembered.
46
47                         For manually created networks this is set by
48                         default.
49
50                 array{byte} WiFi.SSID [readonly]
51
52                         If the network type is WiFi, then this property is
53                         present and contains the binary SSID value.
54
55                 string WiFi.Security [readonly, readwrite]
56
57                         If the network type is WiFi, then this property is
58                         present and contains the security method or key
59                         management setting.
60
61                         For scanned networks this value is read only, but in
62                         case the network was manually created it is also
63                         changeable.
64
65                         Possible values are NONE, WPA and WPA2.
66
67                 string WiFi.Passphrase [readwrite]
68
69                         If the network type is WiFi and a passhrase is
70                         requires, then this property is present and contains
71                         the passphrase in clear text.
72
73                         For system using PolicyKit, the access to this value
74                         will be protected by the security policy.