vcs.maemo.org Git - connman/blob - 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 Address [readonly]
  31
  32                         The address of the network.
  33
  34                 string Name [readonly]
  35
  36                         The pretty/long version of the network name. For
  37                         example in case of WiFi this should be the UTF-8
  38                         valid version of the SSID.
  39
  40                         This property might not be available for every
  41                         network. For example hidden WiFi networks will
  42                         not include it.
  43
  44                 boolean Available [readonly]
  45
  46                         Indicates that this network is in range and
  47                         ready to be used.
  48
  49                         The scanning process can change this property.
  50
  51                 boolean Connected [readonly]
  52
  53                         Indicates that this network is currently connected.
  54
  55                 boolean Remember [readwrite]
  56
  57                         Indicates that this network will be remembered.
  58
  59                         For manually created networks this is set by
  60                         default.
  61
  62                 uint8 Strength [readonly]
  63
  64                         Indicates the signal strength of the network. This
  65                         is a normalized value between 0 and 100.
  66
  67                 object Device [readonly]
  68
  69                         The object path of the device this networks
  70                         belongs to.
  71
  72                 array{byte} WiFi.SSID [readonly]
  73
  74                         If the network type is WiFi, then this property is
  75                         present and contains the binary SSID value.
  76
  77                 string WiFi.Mode [readonly, readwrite]
  78
  79                         If the network type is WiFi, then this property is
  80                         present and contains the mode of the network. The
  81                         possible values are "managed" or "adhoc".
  82
  83                         For scanned networks this value is read only, but in
  84                         case the network was manually created it is also
  85                         changeable.
  86
  87                 string WiFi.Security [readonly, readwrite]
  88
  89                         If the network type is WiFi, then this property is
  90                         present and contains the security method or key
  91                         management setting.
  92
  93                         For scanned networks this value is read only, but in
  94                         case the network was manually created it is also
  95                         changeable.
  96
  97                         Possible values are "none", "wep", "wpa" and "wpa2".
  98
  99                 string WiFi.Passphrase [readwrite]
 100
 101                         If the network type is WiFi and a passhrase is
 102                         requires, then this property is present and contains
 103                         the passphrase in clear text.
 104
 105                         For systems using PolicyKit, the access to this value
 106                         will be protected by the security policy.