libnm-util/NetworkManager.h

   1 /* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
   2 /*
   3  * This program is free software; you can redistribute it and/or modify
   4  * it under the terms of the GNU General Public License as published by
   5  * the Free Software Foundation; either version 2 of the License, or
   6  * (at your option) any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along
  14  * with this program; if not, write to the Free Software Foundation, Inc.,
  15  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  16  *
  17  * Copyright 2004 - 2014 Red Hat, Inc.
  18  */
  19
  20 /* Definitions related to NetworkManager's D-Bus interfaces.
  21  *
  22  * Note that although this header is installed as part of libnm-util, it is also
  23  * used by some external code that does not link to libnm-util.
  24  */
  25
  26 #ifndef NETWORK_MANAGER_H
  27 #define NETWORK_MANAGER_H
  28
  29 /* This header must not include glib or libnm. */
  30
  31 #include <nm-version-macros.h>
  32
  33 /*
  34  * dbus services details
  35  */
  36 #define NM_DBUS_SERVICE                     "org.freedesktop.NetworkManager"
  37
  38 #define NM_DBUS_PATH                        "/org/freedesktop/NetworkManager"
  39 #define NM_DBUS_INTERFACE                   "org.freedesktop.NetworkManager"
  40 #define NM_DBUS_INTERFACE_DEVICE            NM_DBUS_INTERFACE ".Device"
  41 #define NM_DBUS_INTERFACE_DEVICE_WIRED      NM_DBUS_INTERFACE_DEVICE ".Wired"
  42 #define NM_DBUS_INTERFACE_DEVICE_ADSL       NM_DBUS_INTERFACE_DEVICE ".Adsl"
  43 #define NM_DBUS_INTERFACE_DEVICE_WIRELESS   NM_DBUS_INTERFACE_DEVICE ".Wireless"
  44 #define NM_DBUS_INTERFACE_DEVICE_BLUETOOTH  NM_DBUS_INTERFACE_DEVICE ".Bluetooth"
  45 #define NM_DBUS_INTERFACE_DEVICE_OLPC_MESH  NM_DBUS_INTERFACE_DEVICE ".OlpcMesh"
  46 #define NM_DBUS_PATH_ACCESS_POINT           NM_DBUS_PATH "/AccessPoint"
  47 #define NM_DBUS_INTERFACE_ACCESS_POINT      NM_DBUS_INTERFACE ".AccessPoint"
  48 #define NM_DBUS_INTERFACE_DEVICE_MODEM      NM_DBUS_INTERFACE_DEVICE ".Modem"
  49 #define NM_DBUS_INTERFACE_DEVICE_WIMAX      NM_DBUS_INTERFACE_DEVICE ".WiMax"
  50 #define NM_DBUS_INTERFACE_WIMAX_NSP         NM_DBUS_INTERFACE ".WiMax.Nsp"
  51 #define NM_DBUS_PATH_WIMAX_NSP              NM_DBUS_PATH "/Nsp"
  52 #define NM_DBUS_INTERFACE_ACTIVE_CONNECTION NM_DBUS_INTERFACE ".Connection.Active"
  53 #define NM_DBUS_INTERFACE_IP4_CONFIG        NM_DBUS_INTERFACE ".IP4Config"
  54 #define NM_DBUS_INTERFACE_DHCP4_CONFIG      NM_DBUS_INTERFACE ".DHCP4Config"
  55 #define NM_DBUS_INTERFACE_IP6_CONFIG        NM_DBUS_INTERFACE ".IP6Config"
  56 #define NM_DBUS_INTERFACE_DHCP6_CONFIG      NM_DBUS_INTERFACE ".DHCP6Config"
  57 #define NM_DBUS_INTERFACE_DEVICE_INFINIBAND NM_DBUS_INTERFACE_DEVICE ".Infiniband"
  58 #define NM_DBUS_INTERFACE_DEVICE_BOND       NM_DBUS_INTERFACE_DEVICE ".Bond"
  59 #define NM_DBUS_INTERFACE_DEVICE_TEAM       NM_DBUS_INTERFACE_DEVICE ".Team"
  60 #define NM_DBUS_INTERFACE_DEVICE_VLAN       NM_DBUS_INTERFACE_DEVICE ".Vlan"
  61 #define NM_DBUS_INTERFACE_DEVICE_BRIDGE     NM_DBUS_INTERFACE_DEVICE ".Bridge"
  62 #define NM_DBUS_INTERFACE_DEVICE_GENERIC    NM_DBUS_INTERFACE_DEVICE ".Generic"
  63 #define NM_DBUS_INTERFACE_DEVICE_VETH       NM_DBUS_INTERFACE_DEVICE ".Veth"
  64 #define NM_DBUS_INTERFACE_DEVICE_TUN        NM_DBUS_INTERFACE_DEVICE ".Tun"
  65 #define NM_DBUS_INTERFACE_DEVICE_MACVLAN    NM_DBUS_INTERFACE_DEVICE ".Macvlan"
  66 #define NM_DBUS_INTERFACE_DEVICE_VXLAN      NM_DBUS_INTERFACE_DEVICE ".Vxlan"
  67 #define NM_DBUS_INTERFACE_DEVICE_GRE        NM_DBUS_INTERFACE_DEVICE ".Gre"
  68
  69
  70 #define NM_DBUS_IFACE_SETTINGS            "org.freedesktop.NetworkManager.Settings"
  71 #define NM_DBUS_PATH_SETTINGS             "/org/freedesktop/NetworkManager/Settings"
  72
  73 #define NM_DBUS_IFACE_SETTINGS_CONNECTION "org.freedesktop.NetworkManager.Settings.Connection"
  74 #define NM_DBUS_PATH_SETTINGS_CONNECTION  "/org/freedesktop/NetworkManager/Settings/Connection"
  75 #define NM_DBUS_IFACE_SETTINGS_CONNECTION_SECRETS "org.freedesktop.NetworkManager.Settings.Connection.Secrets"
  76
  77 #define NM_DBUS_INTERFACE_AGENT_MANAGER   NM_DBUS_INTERFACE ".AgentManager"
  78 #define NM_DBUS_PATH_AGENT_MANAGER        "/org/freedesktop/NetworkManager/AgentManager"
  79
  80 #define NM_DBUS_INTERFACE_SECRET_AGENT    NM_DBUS_INTERFACE ".SecretAgent"
  81 #define NM_DBUS_PATH_SECRET_AGENT         "/org/freedesktop/NetworkManager/SecretAgent"
  82
  83 /**
  84  * NMState:
  85  * @NM_STATE_UNKNOWN: networking state is unknown
  86  * @NM_STATE_ASLEEP: networking is not enabled
  87  * @NM_STATE_DISCONNECTED: there is no active network connection
  88  * @NM_STATE_DISCONNECTING: network connections are being cleaned up
  89  * @NM_STATE_CONNECTING: a network connection is being started
  90  * @NM_STATE_CONNECTED_LOCAL: there is only local IPv4 and/or IPv6 connectivity
  91  * @NM_STATE_CONNECTED_SITE: there is only site-wide IPv4 and/or IPv6 connectivity
  92  * @NM_STATE_CONNECTED_GLOBAL: there is global IPv4 and/or IPv6 Internet connectivity
  93  *
  94  * #NMState values indicate the current overall networking state.
  95  *
  96  * (Corresponds to the NM_STATE type in nm-manager.xml.)
  97  **/
  98 typedef enum {
  99         NM_STATE_UNKNOWN          = 0,
 100         NM_STATE_ASLEEP           = 10,
 101         NM_STATE_DISCONNECTED     = 20,
 102         NM_STATE_DISCONNECTING    = 30,
 103         NM_STATE_CONNECTING       = 40,
 104         NM_STATE_CONNECTED_LOCAL  = 50,
 105         NM_STATE_CONNECTED_SITE   = 60,
 106         NM_STATE_CONNECTED_GLOBAL = 70
 107 } NMState;
 108
 109 /* For backwards compat */
 110 #define NM_STATE_CONNECTED NM_STATE_CONNECTED_GLOBAL
 111
 112 /**
 113  * NMConnectivityState:
 114  * @NM_CONNECTIVITY_UNKNOWN: Network connectivity is unknown.
 115  * @NM_CONNECTIVITY_NONE: The host is not connected to any network.
 116  * @NM_CONNECTIVITY_PORTAL: The host is behind a captive portal and
 117  *   cannot reach the full Internet.
 118  * @NM_CONNECTIVITY_LIMITED: The host is connected to a network, but
 119  *   does not appear to be able to reach the full Internet.
 120  * @NM_CONNECTIVITY_FULL: The host is connected to a network, and
 121  *   appears to be able to reach the full Internet.
 122  *
 123  * (Corresponds to the NM_CONNECTIVITY type in nm-manager.xml.)
 124  *
 125  * Since: 0.9.8.6
 126  */
 127 typedef enum {
 128         NM_CONNECTIVITY_UNKNOWN,
 129         NM_CONNECTIVITY_NONE,
 130         NM_CONNECTIVITY_PORTAL,
 131         NM_CONNECTIVITY_LIMITED,
 132         NM_CONNECTIVITY_FULL
 133 } NMConnectivityState;
 134
 135 /**
 136  * NMDeviceType:
 137  * @NM_DEVICE_TYPE_UNKNOWN: unknown device
 138  * @NM_DEVICE_TYPE_GENERIC: generic support for unrecognized device types
 139  * @NM_DEVICE_TYPE_ETHERNET: a wired ethernet device
 140  * @NM_DEVICE_TYPE_WIFI: an 802.11 WiFi device
 141  * @NM_DEVICE_TYPE_UNUSED1: not used
 142  * @NM_DEVICE_TYPE_UNUSED2: not used
 143  * @NM_DEVICE_TYPE_BT: a Bluetooth device supporting PAN or DUN access protocols
 144  * @NM_DEVICE_TYPE_OLPC_MESH: an OLPC XO mesh networking device
 145  * @NM_DEVICE_TYPE_WIMAX: an 802.16e Mobile WiMAX broadband device
 146  * @NM_DEVICE_TYPE_MODEM: a modem supporting analog telephone, CDMA/EVDO,
 147  * GSM/UMTS, or LTE network access protocols
 148  * @NM_DEVICE_TYPE_INFINIBAND: an IP-over-InfiniBand device
 149  * @NM_DEVICE_TYPE_BOND: a bond master interface
 150  * @NM_DEVICE_TYPE_VLAN: an 802.1Q VLAN interface
 151  * @NM_DEVICE_TYPE_ADSL: ADSL modem
 152  * @NM_DEVICE_TYPE_BRIDGE: a bridge master interface
 153  * @NM_DEVICE_TYPE_TEAM: a team master interface
 154  * @NM_DEVICE_TYPE_TUN: a TUN/TAP interface
 155  * @NM_DEVICE_TYPE_IP_TUNNEL: an IP tunnel interface
 156  * @NM_DEVICE_TYPE_MACVLAN: a MACVLAN interface
 157  * @NM_DEVICE_TYPE_VXLAN: a VXLAN interface
 158  * @NM_DEVICE_TYPE_VETH: a VETH interface
 159  *
 160  * #NMDeviceType values indicate the type of hardware represented by
 161  * an #NMDevice.
 162  *
 163  * (Corresponds to the NM_DEVICE_TYPE type in nm-device.xml.)
 164  **/
 165 typedef enum {
 166         NM_DEVICE_TYPE_UNKNOWN    = 0,
 167         NM_DEVICE_TYPE_ETHERNET   = 1,
 168         NM_DEVICE_TYPE_WIFI       = 2,
 169         NM_DEVICE_TYPE_UNUSED1    = 3,
 170         NM_DEVICE_TYPE_UNUSED2    = 4,
 171         NM_DEVICE_TYPE_BT         = 5,  /* Bluetooth */
 172         NM_DEVICE_TYPE_OLPC_MESH  = 6,
 173         NM_DEVICE_TYPE_WIMAX      = 7,
 174         NM_DEVICE_TYPE_MODEM      = 8,
 175         NM_DEVICE_TYPE_INFINIBAND = 9,
 176         NM_DEVICE_TYPE_BOND       = 10,
 177         NM_DEVICE_TYPE_VLAN       = 11,
 178         NM_DEVICE_TYPE_ADSL       = 12,
 179         NM_DEVICE_TYPE_BRIDGE     = 13,
 180         NM_DEVICE_TYPE_GENERIC    = 14,
 181         NM_DEVICE_TYPE_TEAM       = 15,
 182         NM_DEVICE_TYPE_TUN        = 16,
 183         NM_DEVICE_TYPE_IP_TUNNEL  = 17,
 184         NM_DEVICE_TYPE_MACVLAN    = 18,
 185         NM_DEVICE_TYPE_VXLAN      = 19,
 186         NM_DEVICE_TYPE_VETH       = 20,
 187 } NMDeviceType;
 188
 189 /**
 190  * NMDeviceCapabilities:
 191  * @NM_DEVICE_CAP_NONE: device has no special capabilities
 192  * @NM_DEVICE_CAP_NM_SUPPORTED: NetworkManager supports this device
 193  * @NM_DEVICE_CAP_CARRIER_DETECT: this device can indicate carrier status
 194  * @NM_DEVICE_CAP_IS_SOFTWARE: this device is a software device
 195  *
 196  * General device capability flags.
 197  *
 198  * (Corresponds to the NM_DEVICE_CAP type in nm-device-wifi.xml.)
 199  **/
 200 typedef enum { /*< flags >*/
 201         NM_DEVICE_CAP_NONE           = 0x00000000,
 202         NM_DEVICE_CAP_NM_SUPPORTED   = 0x00000001,
 203         NM_DEVICE_CAP_CARRIER_DETECT = 0x00000002,
 204         NM_DEVICE_CAP_IS_SOFTWARE    = 0x00000004,
 205 } NMDeviceCapabilities;
 206
 207
 208 /**
 209  * NMDeviceWifiCapabilities:
 210  * @NM_WIFI_DEVICE_CAP_NONE: device has no encryption/authentication capabilities
 211  * @NM_WIFI_DEVICE_CAP_CIPHER_WEP40: device supports 40/64-bit WEP encryption
 212  * @NM_WIFI_DEVICE_CAP_CIPHER_WEP104: device supports 104/128-bit WEP encryption
 213  * @NM_WIFI_DEVICE_CAP_CIPHER_TKIP: device supports TKIP encryption
 214  * @NM_WIFI_DEVICE_CAP_CIPHER_CCMP: device supports AES/CCMP encryption
 215  * @NM_WIFI_DEVICE_CAP_WPA: device supports WPA1 authentication
 216  * @NM_WIFI_DEVICE_CAP_RSN: device supports WPA2/RSN authentication
 217  * @NM_WIFI_DEVICE_CAP_AP: device supports Access Point mode
 218  * @NM_WIFI_DEVICE_CAP_ADHOC: device supports Ad-Hoc mode
 219  * @NM_WIFI_DEVICE_CAP_FREQ_VALID: device reports frequency capabilities
 220  * @NM_WIFI_DEVICE_CAP_FREQ_2GHZ: device supports 2.4GHz frequencies
 221  * @NM_WIFI_DEVICE_CAP_FREQ_5GHZ: device supports 5GHz frequencies
 222  *
 223  * 802.11 specific device encryption and authentication capabilities.
 224  *
 225  * (Corresponds to the NM_802_11_DEVICE_CAP type in nm-device-wifi.xml.)
 226  **/
 227 typedef enum { /*< flags >*/
 228         NM_WIFI_DEVICE_CAP_NONE          = 0x00000000,
 229         NM_WIFI_DEVICE_CAP_CIPHER_WEP40  = 0x00000001,
 230         NM_WIFI_DEVICE_CAP_CIPHER_WEP104 = 0x00000002,
 231         NM_WIFI_DEVICE_CAP_CIPHER_TKIP   = 0x00000004,
 232         NM_WIFI_DEVICE_CAP_CIPHER_CCMP   = 0x00000008,
 233         NM_WIFI_DEVICE_CAP_WPA           = 0x00000010,
 234         NM_WIFI_DEVICE_CAP_RSN           = 0x00000020,
 235         NM_WIFI_DEVICE_CAP_AP            = 0x00000040,
 236         NM_WIFI_DEVICE_CAP_ADHOC         = 0x00000080,
 237         NM_WIFI_DEVICE_CAP_FREQ_VALID    = 0x00000100,
 238         NM_WIFI_DEVICE_CAP_FREQ_2GHZ     = 0x00000200,
 239         NM_WIFI_DEVICE_CAP_FREQ_5GHZ     = 0x00000400,
 240 } NMDeviceWifiCapabilities;
 241
 242
 243 /**
 244  * NM80211ApFlags:
 245  * @NM_802_11_AP_FLAGS_NONE: access point has no special capabilities
 246  * @NM_802_11_AP_FLAGS_PRIVACY: access point requires authentication and
 247  * encryption (usually means WEP)
 248  *
 249  * 802.11 access point flags.
 250  *
 251  * (Corresponds to the NM_802_11_AP_FLAGS type in nm-access-point.xml.)
 252  **/
 253 typedef enum { /*< underscore_name=nm_802_11_ap_flags, flags >*/
 254         NM_802_11_AP_FLAGS_NONE    = 0x00000000,
 255         NM_802_11_AP_FLAGS_PRIVACY = 0x00000001
 256 } NM80211ApFlags;
 257
 258 /**
 259  * NM80211ApSecurityFlags:
 260  * @NM_802_11_AP_SEC_NONE: the access point has no special security requirements
 261  * @NM_802_11_AP_SEC_PAIR_WEP40: 40/64-bit WEP is supported for
 262  * pairwise/unicast encryption
 263  * @NM_802_11_AP_SEC_PAIR_WEP104: 104/128-bit WEP is supported for
 264  * pairwise/unicast encryption
 265  * @NM_802_11_AP_SEC_PAIR_TKIP: TKIP is supported for pairwise/unicast encryption
 266  * @NM_802_11_AP_SEC_PAIR_CCMP: AES/CCMP is supported for pairwise/unicast encryption
 267  * @NM_802_11_AP_SEC_GROUP_WEP40: 40/64-bit WEP is supported for group/broadcast
 268  * encryption
 269  * @NM_802_11_AP_SEC_GROUP_WEP104: 104/128-bit WEP is supported for
 270  * group/broadcast encryption
 271  * @NM_802_11_AP_SEC_GROUP_TKIP: TKIP is supported for group/broadcast encryption
 272  * @NM_802_11_AP_SEC_GROUP_CCMP: AES/CCMP is supported for group/broadcast
 273  * encryption
 274  * @NM_802_11_AP_SEC_KEY_MGMT_PSK: WPA/RSN Pre-Shared Key encryption is
 275  * supported
 276  * @NM_802_11_AP_SEC_KEY_MGMT_802_1X: 802.1x authentication and key management
 277  * is supported
 278  *
 279  * 802.11 access point security and authentication flags.  These flags describe
 280  * the current security requirements of an access point as determined from the
 281  * access point's beacon.
 282  *
 283  * (Corresponds to the NM_802_11_AP_SEC type in nm-access-point.xml.)
 284  **/
 285 typedef enum { /*< underscore_name=nm_802_11_ap_security_flags, flags >*/
 286         NM_802_11_AP_SEC_NONE            = 0x00000000,
 287         NM_802_11_AP_SEC_PAIR_WEP40      = 0x00000001,
 288         NM_802_11_AP_SEC_PAIR_WEP104     = 0x00000002,
 289         NM_802_11_AP_SEC_PAIR_TKIP       = 0x00000004,
 290         NM_802_11_AP_SEC_PAIR_CCMP       = 0x00000008,
 291         NM_802_11_AP_SEC_GROUP_WEP40     = 0x00000010,
 292         NM_802_11_AP_SEC_GROUP_WEP104    = 0x00000020,
 293         NM_802_11_AP_SEC_GROUP_TKIP      = 0x00000040,
 294         NM_802_11_AP_SEC_GROUP_CCMP      = 0x00000080,
 295         NM_802_11_AP_SEC_KEY_MGMT_PSK    = 0x00000100,
 296         NM_802_11_AP_SEC_KEY_MGMT_802_1X = 0x00000200
 297 } NM80211ApSecurityFlags;
 298
 299 /**
 300  * NM80211Mode:
 301  * @NM_802_11_MODE_UNKNOWN: the device or access point mode is unknown
 302  * @NM_802_11_MODE_ADHOC: for both devices and access point objects, indicates
 303  *   the object is part of an Ad-Hoc 802.11 network without a central
 304  *   coordinating access point.
 305  * @NM_802_11_MODE_INFRA: the device or access point is in infrastructure mode.
 306  *   For devices, this indicates the device is an 802.11 client/station.  For
 307  *   access point objects, this indicates the object is an access point that
 308  *   provides connectivity to clients.
 309  * @NM_802_11_MODE_AP: the device is an access point/hotspot.  Not valid for
 310  *   access point objects; used only for hotspot mode on the local machine.
 311  *
 312  * Indicates the 802.11 mode an access point or device is currently in.
 313  *
 314  * (Corresponds to the NM_802_11_MODE type in generic-types.xml.)
 315  **/
 316 typedef enum { /*< underscore_name=nm_802_11_mode >*/
 317         NM_802_11_MODE_UNKNOWN = 0,
 318         NM_802_11_MODE_ADHOC,
 319         NM_802_11_MODE_INFRA,
 320         NM_802_11_MODE_AP
 321 } NM80211Mode;
 322
 323 /**
 324  * NMBluetoothCapabilities:
 325  * @NM_BT_CAPABILITY_NONE: device has no usable capabilities
 326  * @NM_BT_CAPABILITY_DUN: device provides Dial-Up Networking capability
 327  * @NM_BT_CAPABILITY_NAP: device provides Network Access Point capability
 328  *
 329  * #NMBluetoothCapabilities values indicate the usable capabilities of a
 330  * Bluetooth device.
 331  *
 332  * (Corresponds to the NM_BT_CAPABILITY type in nm-device-bt.xml.)
 333  **/
 334 typedef enum { /*< flags >*/
 335         NM_BT_CAPABILITY_NONE = 0x00000000,
 336         NM_BT_CAPABILITY_DUN  = 0x00000001,
 337         NM_BT_CAPABILITY_NAP  = 0x00000002,
 338 } NMBluetoothCapabilities;
 339
 340 /**
 341  * NMDeviceModemCapabilities:
 342  * @NM_DEVICE_MODEM_CAPABILITY_NONE: modem has no usable capabilities
 343  * @NM_DEVICE_MODEM_CAPABILITY_POTS: modem uses the analog wired telephone
 344  * network and is not a wireless/cellular device
 345  * @NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO: modem supports at least one of CDMA
 346  * 1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B
 347  * @NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS: modem supports at least one of GSM,
 348  * GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability
 349  * @NM_DEVICE_MODEM_CAPABILITY_LTE: modem has LTE data capability
 350  *
 351  * #NMDeviceModemCapabilities values indicate the generic radio access
 352  * technology families a modem device supports.  For more information on the
 353  * specific access technologies the device supports use the ModemManager D-Bus
 354  * API.
 355  *
 356  * (Corresponds to the NM_DEVICE_MODEM_CAPABILITY type in nm-device-modem.xml.)
 357  **/
 358 typedef enum { /*< flags >*/
 359         NM_DEVICE_MODEM_CAPABILITY_NONE      = 0x00000000,
 360         NM_DEVICE_MODEM_CAPABILITY_POTS      = 0x00000001,
 361         NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO = 0x00000002,
 362         NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS  = 0x00000004,
 363         NM_DEVICE_MODEM_CAPABILITY_LTE       = 0x00000008,
 364 } NMDeviceModemCapabilities;
 365
 366
 367 /**
 368  * NMDeviceState:
 369  * @NM_DEVICE_STATE_UNKNOWN: the device's state is unknown
 370  * @NM_DEVICE_STATE_UNMANAGED: the device is recognized, but not managed by
 371  *   NetworkManager
 372  * @NM_DEVICE_STATE_UNAVAILABLE: the device is managed by NetworkManager, but
 373  *   is not available for use.  Reasons may include the wireless switched off,
 374  *   missing firmware, no ethernet carrier, missing supplicant or modem manager,
 375  *   etc.
 376  * @NM_DEVICE_STATE_DISCONNECTED: the device can be activated, but is currently
 377  *   idle and not connected to a network.
 378  * @NM_DEVICE_STATE_PREPARE: the device is preparing the connection to the
 379  *   network.  This may include operations like changing the MAC address,
 380  *   setting physical link properties, and anything else required to connect
 381  *   to the requested network.
 382  * @NM_DEVICE_STATE_CONFIG: the device is connecting to the requested network.
 383  *   This may include operations like associating with the WiFi AP, dialing
 384  *   the modem, connecting to the remote Bluetooth device, etc.
 385  * @NM_DEVICE_STATE_NEED_AUTH: the device requires more information to continue
 386  *   connecting to the requested network.  This includes secrets like WiFi
 387  *   passphrases, login passwords, PIN codes, etc.
 388  * @NM_DEVICE_STATE_IP_CONFIG: the device is requesting IPv4 and/or IPv6
 389  *   addresses and routing information from the network.
 390  * @NM_DEVICE_STATE_IP_CHECK: the device is checking whether further action is
 391  *   required for the requested network connection.  This may include checking
 392  *   whether only local network access is available, whether a captive portal
 393  *   is blocking access to the Internet, etc.
 394  * @NM_DEVICE_STATE_SECONDARIES: the device is waiting for a secondary
 395  *   connection (like a VPN) which must activated before the device can be
 396  *   activated
 397  * @NM_DEVICE_STATE_ACTIVATED: the device has a network connection, either local
 398  *   or global.
 399  * @NM_DEVICE_STATE_DEACTIVATING: a disconnection from the current network
 400  *   connection was requested, and the device is cleaning up resources used for
 401  *   that connection.  The network connection may still be valid.
 402  * @NM_DEVICE_STATE_FAILED: the device failed to connect to the requested
 403  *   network and is cleaning up the connection request
 404  *
 405  * (Corresponds to the NM_DEVICE_STATE type in nm-device.xml.)
 406  **/
 407 typedef enum {
 408         NM_DEVICE_STATE_UNKNOWN      = 0,
 409         NM_DEVICE_STATE_UNMANAGED    = 10,
 410         NM_DEVICE_STATE_UNAVAILABLE  = 20,
 411         NM_DEVICE_STATE_DISCONNECTED = 30,
 412         NM_DEVICE_STATE_PREPARE      = 40,
 413         NM_DEVICE_STATE_CONFIG       = 50,
 414         NM_DEVICE_STATE_NEED_AUTH    = 60,
 415         NM_DEVICE_STATE_IP_CONFIG    = 70,
 416         NM_DEVICE_STATE_IP_CHECK     = 80,
 417         NM_DEVICE_STATE_SECONDARIES  = 90,
 418         NM_DEVICE_STATE_ACTIVATED    = 100,
 419         NM_DEVICE_STATE_DEACTIVATING = 110,
 420         NM_DEVICE_STATE_FAILED       = 120
 421 } NMDeviceState;
 422
 423
 424 /**
 425  * NMDeviceStateReason:
 426  * @NM_DEVICE_STATE_REASON_NONE: No reason given
 427  * @NM_DEVICE_STATE_REASON_UNKNOWN: Unknown error
 428  * @NM_DEVICE_STATE_REASON_NOW_MANAGED: Device is now managed
 429  * @NM_DEVICE_STATE_REASON_NOW_UNMANAGED: Device is now unmanaged
 430  * @NM_DEVICE_STATE_REASON_CONFIG_FAILED: The device could not be readied for configuration
 431  * @NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE: IP configuration could not be reserved (no available address, timeout, etc)
 432  * @NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED: The IP config is no longer valid
 433  * @NM_DEVICE_STATE_REASON_NO_SECRETS: Secrets were required, but not provided
 434  * @NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT: 802.1x supplicant disconnected
 435  * @NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED: 802.1x supplicant configuration failed
 436  * @NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED: 802.1x supplicant failed
 437  * @NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT: 802.1x supplicant took too long to authenticate
 438  * @NM_DEVICE_STATE_REASON_PPP_START_FAILED: PPP service failed to start
 439  * @NM_DEVICE_STATE_REASON_PPP_DISCONNECT: PPP service disconnected
 440  * @NM_DEVICE_STATE_REASON_PPP_FAILED: PPP failed
 441  * @NM_DEVICE_STATE_REASON_DHCP_START_FAILED: DHCP client failed to start
 442  * @NM_DEVICE_STATE_REASON_DHCP_ERROR: DHCP client error
 443  * @NM_DEVICE_STATE_REASON_DHCP_FAILED: DHCP client failed
 444  * @NM_DEVICE_STATE_REASON_SHARED_START_FAILED: Shared connection service failed to start
 445  * @NM_DEVICE_STATE_REASON_SHARED_FAILED: Shared connection service failed
 446  * @NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED: AutoIP service failed to start
 447  * @NM_DEVICE_STATE_REASON_AUTOIP_ERROR: AutoIP service error
 448  * @NM_DEVICE_STATE_REASON_AUTOIP_FAILED: AutoIP service failed
 449  * @NM_DEVICE_STATE_REASON_MODEM_BUSY: The line is busy
 450  * @NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE: No dial tone
 451  * @NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER: No carrier could be established
 452  * @NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT: The dialing request timed out
 453  * @NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED: The dialing attempt failed
 454  * @NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED: Modem initialization failed
 455  * @NM_DEVICE_STATE_REASON_GSM_APN_FAILED: Failed to select the specified APN
 456  * @NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING: Not searching for networks
 457  * @NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED: Network registration denied
 458  * @NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT: Network registration timed out
 459  * @NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED: Failed to register with the requested network
 460  * @NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED: PIN check failed
 461  * @NM_DEVICE_STATE_REASON_FIRMWARE_MISSING: Necessary firmware for the device may be missing
 462  * @NM_DEVICE_STATE_REASON_REMOVED: The device was removed
 463  * @NM_DEVICE_STATE_REASON_SLEEPING: NetworkManager went to sleep
 464  * @NM_DEVICE_STATE_REASON_CONNECTION_REMOVED: The device's active connection disappeared
 465  * @NM_DEVICE_STATE_REASON_USER_REQUESTED: Device disconnected by user or client
 466  * @NM_DEVICE_STATE_REASON_CARRIER: Carrier/link changed
 467  * @NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED: The device's existing connection was assumed
 468  * @NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE: The supplicant is now available
 469  * @NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND: The modem could not be found
 470  * @NM_DEVICE_STATE_REASON_BT_FAILED: The Bluetooth connection failed or timed out
 471  * @NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED: GSM Modem's SIM Card not inserted
 472  * @NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED: GSM Modem's SIM Pin required
 473  * @NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED: GSM Modem's SIM Puk required
 474  * @NM_DEVICE_STATE_REASON_GSM_SIM_WRONG: GSM Modem's SIM wrong
 475  * @NM_DEVICE_STATE_REASON_INFINIBAND_MODE: InfiniBand device does not support connected mode
 476  * @NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED: A dependency of the connection failed
 477  * @NM_DEVICE_STATE_REASON_BR2684_FAILED: Problem with the RFC 2684 Ethernet over ADSL bridge
 478  * @NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE: ModemManager not running
 479  * @NM_DEVICE_STATE_REASON_SSID_NOT_FOUND: The WiFi network could not be found
 480  * @NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED: A secondary connection of the base connection failed
 481  * @NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED: DCB or FCoE setup failed
 482  * @NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED: teamd control failed
 483  * @NM_DEVICE_STATE_REASON_MODEM_FAILED: Modem failed or no longer available
 484  * @NM_DEVICE_STATE_REASON_MODEM_AVAILABLE: Modem now ready and available
 485  * @NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT: SIM PIN was incorrect
 486  * @NM_DEVICE_STATE_REASON_NEW_ACTIVATION: New connection activation was enqueued
 487  * @NM_DEVICE_STATE_REASON_PARENT_CHANGED: the device's parent changed
 488  * @NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED: the device parent's management changed
 489  *
 490  * Device state change reason codes
 491  *
 492  * (Corresponds to the NM_DEVICE_STATE_REASON type in nm-device.xml.)
 493  */
 494 typedef enum {
 495         NM_DEVICE_STATE_REASON_NONE = 0,
 496         NM_DEVICE_STATE_REASON_UNKNOWN = 1,
 497         NM_DEVICE_STATE_REASON_NOW_MANAGED = 2,
 498         NM_DEVICE_STATE_REASON_NOW_UNMANAGED = 3,
 499         NM_DEVICE_STATE_REASON_CONFIG_FAILED = 4,
 500         NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE = 5,
 501         NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED = 6,
 502         NM_DEVICE_STATE_REASON_NO_SECRETS = 7,
 503         NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT = 8,
 504         NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED = 9,
 505         NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED = 10,
 506         NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT = 11,
 507         NM_DEVICE_STATE_REASON_PPP_START_FAILED = 12,
 508         NM_DEVICE_STATE_REASON_PPP_DISCONNECT = 13,
 509         NM_DEVICE_STATE_REASON_PPP_FAILED = 14,
 510         NM_DEVICE_STATE_REASON_DHCP_START_FAILED = 15,
 511         NM_DEVICE_STATE_REASON_DHCP_ERROR = 16,
 512         NM_DEVICE_STATE_REASON_DHCP_FAILED = 17,
 513         NM_DEVICE_STATE_REASON_SHARED_START_FAILED = 18,
 514         NM_DEVICE_STATE_REASON_SHARED_FAILED = 19,
 515         NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED = 20,
 516         NM_DEVICE_STATE_REASON_AUTOIP_ERROR = 21,
 517         NM_DEVICE_STATE_REASON_AUTOIP_FAILED = 22,
 518         NM_DEVICE_STATE_REASON_MODEM_BUSY = 23,
 519         NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE = 24,
 520         NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER = 25,
 521         NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT = 26,
 522         NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED = 27,
 523         NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED = 28,
 524         NM_DEVICE_STATE_REASON_GSM_APN_FAILED = 29,
 525         NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING = 30,
 526         NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED = 31,
 527         NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT = 32,
 528         NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED = 33,
 529         NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED = 34,
 530         NM_DEVICE_STATE_REASON_FIRMWARE_MISSING = 35,
 531         NM_DEVICE_STATE_REASON_REMOVED = 36,
 532         NM_DEVICE_STATE_REASON_SLEEPING = 37,
 533         NM_DEVICE_STATE_REASON_CONNECTION_REMOVED = 38,
 534         NM_DEVICE_STATE_REASON_USER_REQUESTED = 39,
 535         NM_DEVICE_STATE_REASON_CARRIER = 40,
 536         NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED = 41,
 537         NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE = 42,
 538         NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND = 43,
 539         NM_DEVICE_STATE_REASON_BT_FAILED = 44,
 540         NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED = 45,
 541         NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED = 46,
 542         NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED = 47,
 543         NM_DEVICE_STATE_REASON_GSM_SIM_WRONG = 48,
 544         NM_DEVICE_STATE_REASON_INFINIBAND_MODE = 49,
 545         NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED = 50,
 546         NM_DEVICE_STATE_REASON_BR2684_FAILED = 51,
 547         NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE = 52,
 548         NM_DEVICE_STATE_REASON_SSID_NOT_FOUND = 53,
 549         NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED = 54,
 550         NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED = 55,
 551         NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED = 56,
 552         NM_DEVICE_STATE_REASON_MODEM_FAILED = 57,
 553         NM_DEVICE_STATE_REASON_MODEM_AVAILABLE = 58,
 554         NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT = 59,
 555         NM_DEVICE_STATE_REASON_NEW_ACTIVATION = 60,
 556         NM_DEVICE_STATE_REASON_PARENT_CHANGED = 61,
 557         NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED = 62,
 558
 559         NM_DEVICE_STATE_REASON_LAST = 0xFFFF
 560 } NMDeviceStateReason;
 561
 562
 563 /**
 564  * NMActiveConnectionState:
 565  * @NM_ACTIVE_CONNECTION_STATE_UNKNOWN: the state of the connection is unknown
 566  * @NM_ACTIVE_CONNECTION_STATE_ACTIVATING: a network connection is being prepared
 567  * @NM_ACTIVE_CONNECTION_STATE_ACTIVATED: there is a connection to the network
 568  * @NM_ACTIVE_CONNECTION_STATE_DEACTIVATING: the network connection is being
 569  *   torn down and cleaned up
 570  * @NM_ACTIVE_CONNECTION_STATE_DEACTIVATED: the network connection is disconnected
 571  *   and will be removed
 572  *
 573  * #NMActiveConnectionState values indicate the state of a connection to a
 574  * specific network while it is starting, connected, or disconnecting from that
 575  * network.
 576  *
 577  * (Corresponds to the NM_ACTIVE_CONNECTION_STATE type in nm-active-connection.xml.)
 578  **/
 579 typedef enum {
 580         NM_ACTIVE_CONNECTION_STATE_UNKNOWN = 0,
 581         NM_ACTIVE_CONNECTION_STATE_ACTIVATING,
 582         NM_ACTIVE_CONNECTION_STATE_ACTIVATED,
 583         NM_ACTIVE_CONNECTION_STATE_DEACTIVATING,
 584         NM_ACTIVE_CONNECTION_STATE_DEACTIVATED
 585 } NMActiveConnectionState;
 586
 587 #endif /* NETWORK_MANAGER_H */