NetworkManager D-Bus API Types 3 NetworkManager D-Bus API Types
NetworkManager D-Bus API Types

## enum NMCapability

NMCapability names the numbers in the Capabilities property. Capabilities are positive numbers. They are part of stable API and a certain capability number is guaranteed not to change.

The range 0x7000 - 0x7FFF of capabilities is guaranteed not to be used by upstream NetworkManager. It could thus be used for downstream extensions.

### Values

NM_CAPABILITY_TEAM | = `1` | Teams can be managed. This means the team device plugin is loaded.
NM_CAPABILITY_OVS | = `2` | OpenVSwitch can be managed. This means the OVS device plugin is loaded. Since: 1.24.

NMCapability

## enum NMState

NMState values indicate the current overall networking state.

### Values

NM_STATE_UNKNOWN | = `0` | Networking state is unknown. This indicates a daemon error that makes it unable to reasonably assess the state. In such event the applications are expected to assume Internet connectivity might be present and not disable controls that require network access. The graphical shells may hide the network accessibility indicator altogether since no meaningful status indication can be provided.
NM_STATE_ASLEEP | = `10` | Networking is not enabled, the system is being suspended or resumed from suspend.
NM_STATE_DISCONNECTED | = `20` | There is no active network connection. The graphical shell should indicate no network connectivity and the applications should not attempt to access the network.
NM_STATE_DISCONNECTING | = `30` | Network connections are being cleaned up. The applications should tear down their network sessions.
NM_STATE_CONNECTING | = `40` | A network connection is being started The graphical shell should indicate the network is being connected while the applications should still make no attempts to connect the network.
NM_STATE_CONNECTED_LOCAL | = `50` | There is only local IPv4 and/or IPv6 connectivity, but no default route to access the Internet. The graphical shell should indicate no network connectivity.
NM_STATE_CONNECTED_SITE | = `60` | There is only site-wide IPv4 and/or IPv6 connectivity. This means a default route is available, but the Internet connectivity check (see "Connectivity" property) did not succeed. The graphical shell should indicate limited network connectivity.
NM_STATE_CONNECTED_GLOBAL | = `70` | There is global IPv4 and/or IPv6 Internet connectivity This means the Internet connectivity check succeeded, the graphical shell should indicate full network connectivity.

NMState

## enum NMConnectivityState

### Values

NM_CONNECTIVITY_UNKNOWN | = `0` | Network connectivity is unknown. This means the connectivity checks are disabled (e.g. on server installations) or has not run yet. The graphical shell should assume the Internet connection might be available and not present a captive portal window.
NM_CONNECTIVITY_NONE | = `1` | The host is not connected to any network. There's no active connection that contains a default route to the internet and thus it makes no sense to even attempt a connectivity check. The graphical shell should use this state to indicate the network connection is unavailable.
NM_CONNECTIVITY_PORTAL | = `2` | The Internet connection is hijacked by a captive portal gateway. The graphical shell may open a sandboxed web browser window (because the captive portals typically attempt a man-in-the-middle attacks against the https connections) for the purpose of authenticating to a gateway and retrigger the connectivity check with CheckConnectivity() when the browser window is dismissed.
NM_CONNECTIVITY_LIMITED | = `3` | The host is connected to a network, does not appear to be able to reach the full Internet, but a captive portal has not been detected.
NM_CONNECTIVITY_FULL | = `4` | The host is connected to a network, and appears to be able to reach the full Internet.

NMConnectivityState

## enum NMDeviceType

NMDeviceType values indicate the type of hardware represented by a device object.

### Values

NM_DEVICE_TYPE_UNKNOWN | = `0` | unknown device
NM_DEVICE_TYPE_GENERIC | = `14` | generic support for unrecognized device types
NM_DEVICE_TYPE_ETHERNET | = `1` | a wired ethernet device
NM_DEVICE_TYPE_WIFI | = `2` | an 802.11 Wi-Fi device
NM_DEVICE_TYPE_UNUSED1 | = `3` | not used
NM_DEVICE_TYPE_UNUSED2 | = `4` | not used
NM_DEVICE_TYPE_BT | = `5` | a Bluetooth device supporting PAN or DUN access protocols
NM_DEVICE_TYPE_OLPC_MESH | = `6` | an OLPC XO mesh networking device
NM_DEVICE_TYPE_WIMAX | = `7` | an 802.16e Mobile WiMAX broadband device
NM_DEVICE_TYPE_MODEM | = `8` | a modem supporting analog telephone, CDMA/EVDO, GSM/UMTS, or LTE network access protocols
NM_DEVICE_TYPE_INFINIBAND | = `9` | an IP-over-InfiniBand device
NM_DEVICE_TYPE_BOND | = `10` | a bond master interface
NM_DEVICE_TYPE_VLAN | = `11` | an 802.1Q VLAN interface
NM_DEVICE_TYPE_ADSL | = `12` | ADSL modem
NM_DEVICE_TYPE_BRIDGE | = `13` | a bridge master interface
NM_DEVICE_TYPE_TEAM | = `15` | a team master interface
NM_DEVICE_TYPE_TUN | = `16` | a TUN or TAP interface
NM_DEVICE_TYPE_IP_TUNNEL | = `17` | a IP tunnel interface
NM_DEVICE_TYPE_MACVLAN | = `18` | a MACVLAN interface
NM_DEVICE_TYPE_VXLAN | = `19` | a VXLAN interface
NM_DEVICE_TYPE_VETH | = `20` | a VETH interface
NM_DEVICE_TYPE_MACSEC | = `21` | a MACsec interface
NM_DEVICE_TYPE_DUMMY | = `22` | a dummy interface
NM_DEVICE_TYPE_PPP | = `23` | a PPP interface
NM_DEVICE_TYPE_OVS_INTERFACE | = `24` | a Open vSwitch interface
NM_DEVICE_TYPE_OVS_PORT | = `25` | a Open vSwitch port
NM_DEVICE_TYPE_OVS_BRIDGE | = `26` | a Open vSwitch bridge
NM_DEVICE_TYPE_WPAN | = `27` | a IEEE 802.15.4 (WPAN) MAC Layer Device
NM_DEVICE_TYPE_6LOWPAN | = `28` | 6LoWPAN interface
NM_DEVICE_TYPE_WIREGUARD | = `29` | a WireGuard interface
NM_DEVICE_TYPE_WIFI_P2P | = `30` | an 802.11 Wi-Fi P2P device. Since: 1.16.
NM_DEVICE_TYPE_VRF | = `31` | A VRF (Virtual Routing and Forwarding) interface. Since: 1.24.

NMDeviceType

## enum NMDeviceCapabilities

General device capability flags.

### Values

NM_DEVICE_CAP_NONE | = `0x00000000` | device has no special capabilities
NM_DEVICE_CAP_NM_SUPPORTED | = `0x00000001` | NetworkManager supports this device
NM_DEVICE_CAP_CARRIER_DETECT | = `0x00000002` | this device can indicate carrier status
NM_DEVICE_CAP_IS_SOFTWARE | = `0x00000004` | this device is a software device
NM_DEVICE_CAP_SRIOV | = `0x00000008` | this device supports single-root I/O virtualization

NMDeviceCapabilities

## enum NMDeviceWifiCapabilities

802.11 specific device encryption and authentication capabilities.

### Values

NM_WIFI_DEVICE_CAP_NONE | = `0x00000000` | device has no encryption/authentication capabilities
NM_WIFI_DEVICE_CAP_CIPHER_WEP40 | = `0x00000001` | device supports 40/64-bit WEP encryption
NM_WIFI_DEVICE_CAP_CIPHER_WEP104 | = `0x00000002` | device supports 104/128-bit WEP encryption
NM_WIFI_DEVICE_CAP_CIPHER_TKIP | = `0x00000004` | device supports TKIP encryption
NM_WIFI_DEVICE_CAP_CIPHER_CCMP | = `0x00000008` | device supports AES/CCMP encryption
NM_WIFI_DEVICE_CAP_WPA | = `0x00000010` | device supports WPA1 authentication
NM_WIFI_DEVICE_CAP_RSN | = `0x00000020` | device supports WPA2/RSN authentication
NM_WIFI_DEVICE_CAP_AP | = `0x00000040` | device supports Access Point mode
NM_WIFI_DEVICE_CAP_ADHOC | = `0x00000080` | device supports Ad-Hoc mode
NM_WIFI_DEVICE_CAP_FREQ_VALID | = `0x00000100` | device reports frequency capabilities
NM_WIFI_DEVICE_CAP_FREQ_2GHZ | = `0x00000200` | device supports 2.4GHz frequencies
NM_WIFI_DEVICE_CAP_FREQ_5GHZ | = `0x00000400` | device supports 5GHz frequencies
NM_WIFI_DEVICE_CAP_MESH | = `0x00001000` | device supports acting as a mesh point. Since: 1.20.
NM_WIFI_DEVICE_CAP_IBSS_RSN | = `0x00002000` | device supports WPA2/RSN in an IBSS network. Since: 1.22.

NMDeviceWifiCapabilities

## enum NM80211ApFlags

802.11 access point flags.

### Values

NM_802_11_AP_FLAGS_NONE | = `0x00000000` | access point has no special capabilities
NM_802_11_AP_FLAGS_PRIVACY | = `0x00000001` | access point requires authentication and encryption (usually means WEP)
NM_802_11_AP_FLAGS_WPS | = `0x00000002` | access point supports some WPS method
NM_802_11_AP_FLAGS_WPS_PBC | = `0x00000004` | access point supports push-button WPS
NM_802_11_AP_FLAGS_WPS_PIN | = `0x00000008` | access point supports PIN-based WPS

NM80211ApFlags

## enum NM80211ApSecurityFlags

802.11 access point security and authentication flags. These flags describe the current security requirements of an access point as determined from the access point's beacon.

### Values

NM_802_11_AP_SEC_NONE | = `0x00000000` | the access point has no special security requirements
NM_802_11_AP_SEC_PAIR_WEP40 | = `0x00000001` | 40/64-bit WEP is supported for pairwise/unicast encryption
NM_802_11_AP_SEC_PAIR_WEP104 | = `0x00000002` | 104/128-bit WEP is supported for pairwise/unicast encryption
NM_802_11_AP_SEC_PAIR_TKIP | = `0x00000004` | TKIP is supported for pairwise/unicast encryption
NM_802_11_AP_SEC_PAIR_CCMP | = `0x00000008` | AES/CCMP is supported for pairwise/unicast encryption
NM_802_11_AP_SEC_GROUP_WEP40 | = `0x00000010` | 40/64-bit WEP is supported for group/broadcast encryption
NM_802_11_AP_SEC_GROUP_WEP104 | = `0x00000020` | 104/128-bit WEP is supported for group/broadcast encryption
NM_802_11_AP_SEC_GROUP_TKIP | = `0x00000040` | TKIP is supported for group/broadcast encryption
NM_802_11_AP_SEC_GROUP_CCMP | = `0x00000080` | AES/CCMP is supported for group/broadcast encryption
NM_802_11_AP_SEC_KEY_MGMT_PSK | = `0x00000100` | WPA/RSN Pre-Shared Key encryption is supported
NM_802_11_AP_SEC_KEY_MGMT_802_1X | = `0x00000200` | 802.1x authentication and key management is supported
NM_802_11_AP_SEC_KEY_MGMT_SAE | = `0x00000400` | WPA/RSN Simultaneous Authentication of Equals is supported
NM_802_11_AP_SEC_KEY_MGMT_OWE | = `0x00000800` | WPA/RSN Opportunistic Wireless Encryption is supported
NM_802_11_AP_SEC_KEY_MGMT_OWE_TM | = `0x00001000` | WPA/RSN Opportunistic Wireless Encryption transition mode is supported. Since: 1.26.
NM_802_11_AP_SEC_KEY_MGMT_EAP_SUITE_B_192 | = `0x00002000` | WPA3 Enterprise Suite-B 192 bit mode is supported. Since: 1.30.

NM80211ApSecurityFlags

## enum NM80211Mode

Indicates the 802.11 mode an access point or device is currently in.

### Values

NM_802_11_MODE_UNKNOWN | = `0` | the device or access point mode is unknown
NM_802_11_MODE_ADHOC | = `1` | for both devices and access point objects, indicates the object is part of an Ad-Hoc 802.11 network without a central coordinating access point.
NM_802_11_MODE_INFRA | = `2` | the device or access point is in infrastructure mode. For devices, this indicates the device is an 802.11 client/station. For access point objects, this indicates the object is an access point that provides connectivity to clients.
NM_802_11_MODE_AP | = `3` | the device is an access point/hotspot. Not valid for access point objects; used only for hotspot mode on the local machine.
NM_802_11_MODE_MESH | = `4` | the device is a 802.11s mesh point. Since: 1.20.

NM80211Mode

## enum NMBluetoothCapabilities

NMBluetoothCapabilities values indicate the usable capabilities of a Bluetooth device.

### Values

NM_BT_CAPABILITY_NONE | = `0x00000000` | device has no usable capabilities
NM_BT_CAPABILITY_DUN | = `0x00000001` | device provides Dial-Up Networking capability
NM_BT_CAPABILITY_NAP | = `0x00000002` | device provides Network Access Point capability

NMBluetoothCapabilities

## enum NMDeviceModemCapabilities

NMDeviceModemCapabilities values indicate the generic radio access technology families a modem device supports. For more information on the specific access technologies the device supports use the ModemManager D-Bus API.

### Values

NM_DEVICE_MODEM_CAPABILITY_NONE | = `0x00000000` | modem has no usable capabilities
NM_DEVICE_MODEM_CAPABILITY_POTS | = `0x00000001` | modem uses the analog wired telephone network and is not a wireless/cellular device
NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO | = `0x00000002` | modem supports at least one of CDMA 1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B
NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS | = `0x00000004` | modem supports at least one of GSM, GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability
NM_DEVICE_MODEM_CAPABILITY_LTE | = `0x00000008` | modem has LTE data capability

NMDeviceModemCapabilities

## enum NMWimaxNspNetworkType

WiMAX network type.

### Values

NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN | = `0` | unknown network type
NM_WIMAX_NSP_NETWORK_TYPE_HOME | = `1` | home network
NM_WIMAX_NSP_NETWORK_TYPE_PARTNER | = `2` | partner network
NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER | = `3` | roaming partner network

NMWimaxNspNetworkType

## enum NMDeviceState

### Values

NM_DEVICE_STATE_UNKNOWN | = `0` | the device's state is unknown
NM_DEVICE_STATE_UNMANAGED | = `10` | the device is recognized, but not managed by NetworkManager
NM_DEVICE_STATE_UNAVAILABLE | = `20` | the device is managed by NetworkManager, but is not available for use. Reasons may include the wireless switched off, missing firmware, no ethernet carrier, missing supplicant or modem manager, etc.
NM_DEVICE_STATE_DISCONNECTED | = `30` | the device can be activated, but is currently idle and not connected to a network.
NM_DEVICE_STATE_PREPARE | = `40` | the device is preparing the connection to the network. This may include operations like changing the MAC address, setting physical link properties, and anything else required to connect to the requested network.
NM_DEVICE_STATE_CONFIG | = `50` | the device is connecting to the requested network. This may include operations like associating with the Wi-Fi AP, dialing the modem, connecting to the remote Bluetooth device, etc.
NM_DEVICE_STATE_NEED_AUTH | = `60` | the device requires more information to continue connecting to the requested network. This includes secrets like WiFi passphrases, login passwords, PIN codes, etc.
NM_DEVICE_STATE_IP_CONFIG | = `70` | the device is requesting IPv4 and/or IPv6 addresses and routing information from the network.
NM_DEVICE_STATE_IP_CHECK | = `80` | the device is checking whether further action is required for the requested network connection. This may include checking whether only local network access is available, whether a captive portal is blocking access to the Internet, etc.
NM_DEVICE_STATE_SECONDARIES | = `90` | the device is waiting for a secondary connection (like a VPN) which must activated before the device can be activated
NM_DEVICE_STATE_ACTIVATED | = `100` | the device has a network connection, either local or global.
NM_DEVICE_STATE_DEACTIVATING | = `110` | a disconnection from the current network connection was requested, and the device is cleaning up resources used for that connection. The network connection may still be valid.
NM_DEVICE_STATE_FAILED | = `120` | the device failed to connect to the requested network and is cleaning up the connection request

NMDeviceState

## enum NMDeviceStateReason

Device state change reason codes

### Values

NM_DEVICE_STATE_REASON_NONE | = `0` | No reason given
NM_DEVICE_STATE_REASON_UNKNOWN | = `1` | Unknown error
NM_DEVICE_STATE_REASON_NOW_MANAGED | = `2` | Device is now managed
NM_DEVICE_STATE_REASON_NOW_UNMANAGED | = `3` | Device is now unmanaged
NM_DEVICE_STATE_REASON_CONFIG_FAILED | = `4` | The device could not be readied for configuration
NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE | = `5` | IP configuration could not be reserved (no available address, timeout, etc)
NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED | = `6` | The IP config is no longer valid
NM_DEVICE_STATE_REASON_NO_SECRETS | = `7` | Secrets were required, but not provided
NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT | = `8` | 802.1x supplicant disconnected
NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED | = `9` | 802.1x supplicant configuration failed
NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED | = `10` | 802.1x supplicant failed
NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT | = `11` | 802.1x supplicant took too long to authenticate
NM_DEVICE_STATE_REASON_PPP_START_FAILED | = `12` | PPP service failed to start
NM_DEVICE_STATE_REASON_PPP_DISCONNECT | = `13` | PPP service disconnected
NM_DEVICE_STATE_REASON_PPP_FAILED | = `14` | PPP failed
NM_DEVICE_STATE_REASON_DHCP_START_FAILED | = `15` | DHCP client failed to start
NM_DEVICE_STATE_REASON_DHCP_ERROR | = `16` | DHCP client error
NM_DEVICE_STATE_REASON_DHCP_FAILED | = `17` | DHCP client failed
NM_DEVICE_STATE_REASON_SHARED_START_FAILED | = `18` | Shared connection service failed to start
NM_DEVICE_STATE_REASON_SHARED_FAILED | = `19` | Shared connection service failed
NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED | = `20` | AutoIP service failed to start
NM_DEVICE_STATE_REASON_AUTOIP_ERROR | = `21` | AutoIP service error
NM_DEVICE_STATE_REASON_AUTOIP_FAILED | = `22` | AutoIP service failed
NM_DEVICE_STATE_REASON_MODEM_BUSY | = `23` | The line is busy
NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE | = `24` | No dial tone
NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER | = `25` | No carrier could be established
NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT | = `26` | The dialing request timed out
NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED | = `27` | The dialing attempt failed
NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED | = `28` | Modem initialization failed
NM_DEVICE_STATE_REASON_GSM_APN_FAILED | = `29` | Failed to select the specified APN
NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING | = `30` | Not searching for networks
NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED | = `31` | Network registration denied
NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT | = `32` | Network registration timed out
NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED | = `33` | Failed to register with the requested network
NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED | = `34` | PIN check failed
NM_DEVICE_STATE_REASON_FIRMWARE_MISSING | = `35` | Necessary firmware for the device may be missing
NM_DEVICE_STATE_REASON_REMOVED | = `36` | The device was removed
NM_DEVICE_STATE_REASON_SLEEPING | = `37` | NetworkManager went to sleep
NM_DEVICE_STATE_REASON_CONNECTION_REMOVED | = `38` | The device's active connection disappeared
NM_DEVICE_STATE_REASON_USER_REQUESTED | = `39` | Device disconnected by user or client
NM_DEVICE_STATE_REASON_CARRIER | = `40` | Carrier/link changed
NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED | = `41` | The device's existing connection was assumed
NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE | = `42` | The supplicant is now available
NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND | = `43` | The modem could not be found
NM_DEVICE_STATE_REASON_BT_FAILED | = `44` | The Bluetooth connection failed or timed out
NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED | = `45` | GSM Modem's SIM Card not inserted
NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED | = `46` | GSM Modem's SIM Pin required
NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED | = `47` | GSM Modem's SIM Puk required
NM_DEVICE_STATE_REASON_GSM_SIM_WRONG | = `48` | GSM Modem's SIM wrong
NM_DEVICE_STATE_REASON_INFINIBAND_MODE | = `49` | InfiniBand device does not support connected mode
NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED | = `50` | A dependency of the connection failed
NM_DEVICE_STATE_REASON_BR2684_FAILED | = `51` | Problem with the RFC 2684 Ethernet over ADSL bridge
NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE | = `52` | ModemManager not running
NM_DEVICE_STATE_REASON_SSID_NOT_FOUND | = `53` | The Wi-Fi network could not be found
NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED | = `54` | A secondary connection of the base connection failed
NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED | = `55` | DCB or FCoE setup failed
NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED | = `56` | teamd control failed
NM_DEVICE_STATE_REASON_MODEM_FAILED | = `57` | Modem failed or no longer available
NM_DEVICE_STATE_REASON_MODEM_AVAILABLE | = `58` | Modem now ready and available
NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT | = `59` | SIM PIN was incorrect
NM_DEVICE_STATE_REASON_NEW_ACTIVATION | = `60` | New connection activation was enqueued
NM_DEVICE_STATE_REASON_PARENT_CHANGED | = `61` | the device's parent changed
NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED | = `62` | the device parent's management changed
NM_DEVICE_STATE_REASON_OVSDB_FAILED | = `63` | problem communicating with Open vSwitch database
NM_DEVICE_STATE_REASON_IP_ADDRESS_DUPLICATE | = `64` | a duplicate IP address was detected
NM_DEVICE_STATE_REASON_IP_METHOD_UNSUPPORTED | = `65` | The selected IP method is not supported
NM_DEVICE_STATE_REASON_SRIOV_CONFIGURATION_FAILED | = `66` | configuration of SR-IOV parameters failed
NM_DEVICE_STATE_REASON_PEER_NOT_FOUND | = `67` | The Wi-Fi P2P peer could not be found

NMDeviceStateReason

## enum NMMetered

The NMMetered enum has two different purposes: one is to configure "connection.metered" setting of a connection profile in NMSettingConnection, and the other is to express the actual metered state of the NMDevice at a given moment.

For the connection profile only NM_METERED_UNKNOWN, NM_METERED_NO and NM_METERED_YES are allowed.

The device's metered state at runtime is determined by the profile which is currently active. If the profile explicitly specifies NM_METERED_NO or NM_METERED_YES, then the device's metered state is as such. If the connection profile leaves it undecided at NM_METERED_UNKNOWN (the default), then NetworkManager tries to guess the metered state, for example based on the device type or on DHCP options (like Android devices exposing a "ANDROID_METERED" DHCP vendor option). This then leads to either NM_METERED_GUESS_NO or NM_METERED_GUESS_YES.

Most applications probably should treat the runtime state NM_METERED_GUESS_YES like NM_METERED_YES, and all other states as not metered.

Note that the per-device metered states are then combined to a global metered state. This is basically the metered state of the device with the best default route. However, that generalization of a global metered state may not be correct if the default routes for IPv4 and IPv6 are on different devices, or if policy routing is configured. In general, the global metered state tries to express whether the traffic is likely metered, but since that depends on the traffic itself, there is not one answer in all cases. Hence, an application may want to consider the per-device's metered states.

Since: 1.2

### Values

NM_METERED_UNKNOWN | = `0` | The metered status is unknown
NM_METERED_YES | = `1` | Metered, the value was explicitly configured
NM_METERED_NO | = `2` | Not metered, the value was explicitly configured
NM_METERED_GUESS_YES | = `3` | Metered, the value was guessed
NM_METERED_GUESS_NO | = `4` | Not metered, the value was guessed

NMMetered

## enum NMConnectionMultiConnect

Since: 1.14

### Values

NM_CONNECTION_MULTI_CONNECT_DEFAULT | = `0` | indicates that the per-connection setting is unspecified. In this case, it will fallback to the default value, which is %NM_CONNECTION_MULTI_CONNECT_SINGLE.
NM_CONNECTION_MULTI_CONNECT_SINGLE | = `1` | the connection profile can only be active once at each moment. Activating a profile that is already active, will first deactivate it.
NM_CONNECTION_MULTI_CONNECT_MANUAL_MULTIPLE | = `2` | the profile can be manually activated multiple times on different devices. However, regarding autoconnect, the profile will autoconnect only if it is currently not connected otherwise.
NM_CONNECTION_MULTI_CONNECT_MULTIPLE | = `3` | the profile can autoactivate and be manually activated multiple times together.

NMConnectionMultiConnect

## enum NMActiveConnectionState

NMActiveConnectionState values indicate the state of a connection to a specific network while it is starting, connected, or disconnecting from that network.

### Values

NM_ACTIVE_CONNECTION_STATE_UNKNOWN | = `0` | the state of the connection is unknown
NM_ACTIVE_CONNECTION_STATE_ACTIVATING | = `1` | a network connection is being prepared
NM_ACTIVE_CONNECTION_STATE_ACTIVATED | = `2` | there is a connection to the network
NM_ACTIVE_CONNECTION_STATE_DEACTIVATING | = `3` | the network connection is being torn down and cleaned up
NM_ACTIVE_CONNECTION_STATE_DEACTIVATED | = `4` | the network connection is disconnected and will be removed

NMActiveConnectionState

## enum NMActiveConnectionStateReason

Active connection state reasons.

Since: 1.8

### Values

NM_ACTIVE_CONNECTION_STATE_REASON_UNKNOWN | = `0` | The reason for the active connection state change is unknown.
NM_ACTIVE_CONNECTION_STATE_REASON_NONE | = `1` | No reason was given for the active connection state change.
NM_ACTIVE_CONNECTION_STATE_REASON_USER_DISCONNECTED | = `2` | The active connection changed state because the user disconnected it.
NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED | = `3` | The active connection changed state because the device it was using was disconnected.
NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_STOPPED | = `4` | The service providing the VPN connection was stopped.
NM_ACTIVE_CONNECTION_STATE_REASON_IP_CONFIG_INVALID | = `5` | The IP config of the active connection was invalid.
NM_ACTIVE_CONNECTION_STATE_REASON_CONNECT_TIMEOUT | = `6` | The connection attempt to the VPN service timed out.
NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT | = `7` | A timeout occurred while starting the service providing the VPN connection.
NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_START_FAILED | = `8` | Starting the service providing the VPN connection failed.
NM_ACTIVE_CONNECTION_STATE_REASON_NO_SECRETS | = `9` | Necessary secrets for the connection were not provided.
NM_ACTIVE_CONNECTION_STATE_REASON_LOGIN_FAILED | = `10` | Authentication to the server failed.
NM_ACTIVE_CONNECTION_STATE_REASON_CONNECTION_REMOVED | = `11` | The connection was deleted from settings.
NM_ACTIVE_CONNECTION_STATE_REASON_DEPENDENCY_FAILED | = `12` | Master connection of this connection failed to activate.
NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_REALIZE_FAILED | = `13` | Could not create the software device link.
NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_REMOVED | = `14` | The device this connection depended on disappeared.

NMActiveConnectionStateReason

## enum NMSecretAgentGetSecretsFlags

NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request.

### Values

NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE | = `0x0` | no special behavior; by default no user interaction is allowed and requests for secrets are fulfilled from persistent storage, or if no secrets are available an error is returned.
NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION | = `0x1` | allows the request to interact with the user, possibly prompting via UI for secrets if any are required, or if none are found in persistent storage.
NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW | = `0x2` | explicitly prompt for new secrets from the user. This flag signals that NetworkManager thinks any existing secrets are invalid or wrong. This flag implies that interaction is allowed.
NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED | = `0x4` | set if the request was initiated by user-requested action via the D-Bus interface, as opposed to automatically initiated by NetworkManager in response to (for example) scan results or carrier changes.
NM_SECRET_AGENT_GET_SECRETS_FLAG_WPS_PBC_ACTIVE | = `0x8` | indicates that WPS enrollment is active with PBC method. The agent may suggest that the user pushes a button on the router instead of supplying a PSK.
NM_SECRET_AGENT_GET_SECRETS_FLAG_ONLY_SYSTEM | = `0x80000000` | Internal flag, not part of the D-Bus API.
NM_SECRET_AGENT_GET_SECRETS_FLAG_NO_ERRORS | = `0x40000000` | Internal flag, not part of the D-Bus API.

NMSecretAgentGetSecretsFlags

## enum NMSecretAgentCapabilities

NMSecretAgentCapabilities indicate various capabilities of the agent.

### Values

NM_SECRET_AGENT_CAPABILITY_NONE | = `0x0` | the agent supports no special capabilities
NM_SECRET_AGENT_CAPABILITY_VPN_HINTS | = `0x1` | the agent supports passing hints to VPN plugin authentication dialogs.

NMSecretAgentCapabilities

## enum NMIPTunnelMode

The tunneling mode.

Since: 1.2

### Values

NM_IP_TUNNEL_MODE_UNKNOWN | = `0` | Unknown/unset tunnel mode
NM_IP_TUNNEL_MODE_IPIP | = `1` | IP in IP tunnel
NM_IP_TUNNEL_MODE_GRE | = `2` | GRE tunnel
NM_IP_TUNNEL_MODE_SIT | = `3` | SIT tunnel
NM_IP_TUNNEL_MODE_ISATAP | = `4` | ISATAP tunnel
NM_IP_TUNNEL_MODE_VTI | = `5` | VTI tunnel
NM_IP_TUNNEL_MODE_IP6IP6 | = `6` | IPv6 in IPv6 tunnel
NM_IP_TUNNEL_MODE_IPIP6 | = `7` | IPv4 in IPv6 tunnel
NM_IP_TUNNEL_MODE_IP6GRE | = `8` | IPv6 GRE tunnel
NM_IP_TUNNEL_MODE_VTI6 | = `9` | IPv6 VTI tunnel
NM_IP_TUNNEL_MODE_GRETAP | = `10` | GRETAP tunnel
NM_IP_TUNNEL_MODE_IP6GRETAP | = `11` | IPv6 GRETAP tunnel

NMIPTunnelMode

## enum NMCheckpointCreateFlags

The flags for CheckpointCreate call

Since: 1.4 (gi flags generated since 1.12)

### Values

NM_CHECKPOINT_CREATE_FLAG_NONE | = `0` | no flags
NM_CHECKPOINT_CREATE_FLAG_DESTROY_ALL | = `0x01` | when creating a new checkpoint, destroy all existing ones.
NM_CHECKPOINT_CREATE_FLAG_DELETE_NEW_CONNECTIONS | = `0x02` | upon rollback, delete any new connection added after the checkpoint. Since: 1.6.
NM_CHECKPOINT_CREATE_FLAG_DISCONNECT_NEW_DEVICES | = `0x04` | upon rollback, disconnect any new device appeared after the checkpoint. Since: 1.6.
NM_CHECKPOINT_CREATE_FLAG_ALLOW_OVERLAPPING | = `0x08` | by default, creating a checkpoint fails if there are already existing checkoints that reference the same devices. With this flag, creation of such checkpoints is allowed, however, if an older checkpoint that references overlapping devices gets rolled back, it will automatically destroy this checkpoint during rollback. This allows to create several overlapping checkpoints in parallel, and rollback to them at will. With the special case that rolling back to an older checkpoint will invalidate all overlapping younger checkpoints. This opts-in that the checkpoint can be automatically destroyed by the rollback of an older checkpoint. Since: 1.12.

NMCheckpointCreateFlags

## enum NMRollbackResult

The result of a checkpoint Rollback() operation for a specific device.

Since: 1.4

### Values

NM_ROLLBACK_RESULT_OK | = `0` | the rollback succeeded.
NM_ROLLBACK_RESULT_ERR_NO_DEVICE | = `1` | the device no longer exists.
NM_ROLLBACK_RESULT_ERR_DEVICE_UNMANAGED | = `2` | the device is now unmanaged.
NM_ROLLBACK_RESULT_ERR_FAILED | = `3` | other errors during rollback.

NMRollbackResult

## enum NMSettingsConnectionFlags

Flags describing the current activation state.

Since: 1.12

### Values

NM_SETTINGS_CONNECTION_FLAG_NONE | = `0` | an alias for numeric zero, no flags set.
NM_SETTINGS_CONNECTION_FLAG_UNSAVED | = `0x01` | the connection is not saved to disk. That either means, that the connection is in-memory only and currently is not backed by a file. Or, that the connection is backed by a file, but has modifications in-memory that were not persisted to disk.
NM_SETTINGS_CONNECTION_FLAG_NM_GENERATED | = `0x02` | A connection is "nm-generated" if it was generated by NetworkManger. If the connection gets modified or saved by the user, the flag gets cleared. A nm-generated is also unsaved and has no backing file as it is in-memory only.
NM_SETTINGS_CONNECTION_FLAG_VOLATILE | = `0x04` | The connection will be deleted when it disconnects. That is for in-memory connections (unsaved), which are currently active but deleted on disconnect. Volatile connections are always unsaved, but they are also no backing file on disk and are entirely in-memory only.
NM_SETTINGS_CONNECTION_FLAG_EXTERNAL | = `0x08` | the profile was generated to represent an external configuration of a networking device. Since: 1.26.

NMSettingsConnectionFlags

## enum NMActivationStateFlags

Flags describing the current activation state.

Since: 1.10

### Values

NM_ACTIVATION_STATE_FLAG_NONE | = `0` | an alias for numeric zero, no flags set.
NM_ACTIVATION_STATE_FLAG_IS_MASTER | = `0x1` | the device is a master.
NM_ACTIVATION_STATE_FLAG_IS_SLAVE | = `0x2` | the device is a slave.
NM_ACTIVATION_STATE_FLAG_LAYER2_READY | = `0x4` | layer2 is activated and ready.
NM_ACTIVATION_STATE_FLAG_IP4_READY | = `0x8` | IPv4 setting is completed.
NM_ACTIVATION_STATE_FLAG_IP6_READY | = `0x10` | IPv6 setting is completed.
NM_ACTIVATION_STATE_FLAG_MASTER_HAS_SLAVES | = `0x20` | The master has any slave devices attached. This only makes sense if the device is a master.
NM_ACTIVATION_STATE_FLAG_LIFETIME_BOUND_TO_PROFILE_VISIBILITY | = `0x40` | the lifetime of the activation is bound to the visibility of the connection profile, which in turn depends on "connection.permissions" and whether a session for the user exists. Since: 1.16.
NM_ACTIVATION_STATE_FLAG_EXTERNAL | = `0x80` | the active connection was generated to represent an external configuration of a networking device. Since: 1.26.

NMActivationStateFlags

## enum NMSettingsAddConnection2Flags

Numeric flags for the "flags" argument of AddConnection2() D-Bus API.

Since: 1.20

### Values

NM_SETTINGS_ADD_CONNECTION2_FLAG_NONE | = `0` | an alias for numeric zero, no flags set.
NM_SETTINGS_ADD_CONNECTION2_FLAG_TO_DISK | = `0x1` | to persist the connection to disk.
NM_SETTINGS_ADD_CONNECTION2_FLAG_IN_MEMORY | = `0x2` | to make the connection in-memory only.
NM_SETTINGS_ADD_CONNECTION2_FLAG_BLOCK_AUTOCONNECT | = `0x20` | usually, when the connection has autoconnect enabled and gets added, it becomes eligible to autoconnect right away. Setting this flag, disables autoconnect until the connection is manually activated.

NMSettingsAddConnection2Flags

## enum NMSettingsUpdate2Flags

Since: 1.12

### Values

NM_SETTINGS_UPDATE2_FLAG_NONE | = `0` | an alias for numeric zero, no flags set.
NM_SETTINGS_UPDATE2_FLAG_TO_DISK | = `0x1` | to persist the connection to disk.
NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY | = `0x2` | makes the profile in-memory. Note that such profiles are stored in keyfile format under /run. If the file is already in-memory, the file in /run is updated in-place. Otherwise, the previous storage for the profile is left unchanged on disk, and the in-memory copy shadows it. Note that the original filename of the previous persistent storage (if any) is remembered. That means, when later persisting the profile again to disk, the file on disk will be overwritten again. Likewise, when finally deleting the profile, both the storage from /run and persistent storage are deleted (or if the persistent storage does not allow deletion, and nmmeta file is written to mark the UUID as deleted).
NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_DETACHED | = `0x4` | this is almost the same as %NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY, with one difference: when later deleting the profile, the original profile will not be deleted. Instead a nmmeta file is written to /run to indicate that the profile is gone. Note that if such a nmmeta tombstone file exists and hides a file in persistent storage, then when re-adding the profile with the same UUID, then the original storage is taken over again.
NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_ONLY | = `0x8` | this is like %NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY, but if the connection has a corresponding file on persistent storage, the file will be deleted right away. If the profile is later again persisted to disk, a new, unused filename will be chosen.
NM_SETTINGS_UPDATE2_FLAG_VOLATILE | = `0x10` | This can be specified with either %NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY, %NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_DETACHED or %NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_ONLY. After making the connection in-memory only, the connection is marked as volatile. That means, if the connection is currently not active it will be deleted right away. Otherwise, it is marked to for deletion once the connection deactivates. A volatile connection cannot autoactivate again (because it's about to be deleted), but a manual activation will clear the volatile flag.
NM_SETTINGS_UPDATE2_FLAG_BLOCK_AUTOCONNECT | = `0x20` | usually, when the connection has autoconnect enabled and is modified, it becomes eligible to autoconnect right away. Setting this flag, disables autoconnect until the connection is manually activated.
NM_SETTINGS_UPDATE2_FLAG_NO_REAPPLY | = `0x40` | when a profile gets modified that is currently active, then these changes don't take effect for the active device unless the profile gets reactivated or the configuration reapplied. There are two exceptions: by default "connection.zone" and "connection.metered" properties take effect immediately. Specify this flag to prevent these properties to take effect, so that the change is restricted to modify the profile. Since: 1.20.

NMSettingsUpdate2Flags

## enum NMTernary

An boolean value that can be overridden by a default.

Since: 1.14

### Values

NM_TERNARY_DEFAULT | = `-1` | use the globally-configured default value.
NM_TERNARY_FALSE | = `0` | the option is disabled.
NM_TERNARY_TRUE | = `1` | the option is enabled.

NMTernary

## enum NMManagerReloadFlags

Flags for the manager Reload() call.

Since: 1.22

### Values

NM_MANAGER_RELOAD_FLAG_NONE | = `0` | an alias for numeric zero, no flags set. This reloads everything that is supported and is identical to a SIGHUP.
NM_MANAGER_RELOAD_FLAG_CONF | = `0x1` | reload the NetworkManager.conf configuration from disk. Note that this does not include connections, which can be reloaded via Setting's ReloadConnections().
NM_MANAGER_RELOAD_FLAG_DNS_RC | = `0x2` | update DNS configuration, which usually involves writing /etc/resolv.conf anew.
NM_MANAGER_RELOAD_FLAG_DNS_FULL | = `0x4` | means to restart the DNS plugin. This is for example useful when using dnsmasq plugin, which uses additional configuration in /etc/NetworkManager/dnsmasq.d. If you edit those files, you can restart the DNS plugin. This action shortly interrupts name resolution.
NM_MANAGER_RELOAD_FLAG_ALL | = `0x7` | all flags.

NMManagerReloadFlags

## enum NMDeviceInterfaceFlags

Flags for a network interface.

Since: 1.22

### Values

NM_DEVICE_INTERFACE_FLAG_NONE | = `0` | an alias for numeric zero, no flags set.
NM_DEVICE_INTERFACE_FLAG_UP | = `0x1` | the interface is enabled from the administrative point of view. Corresponds to kernel IFF_UP.
NM_DEVICE_INTERFACE_FLAG_LOWER_UP | = `0x2` | the physical link is up. Corresponds to kernel IFF_LOWER_UP.
NM_DEVICE_INTERFACE_FLAG_CARRIER | = `0x10000` | the interface has carrier. In most cases this is equal to the value of @NM_DEVICE_INTERFACE_FLAG_LOWER_UP. However some devices have a non-standard carrier detection mechanism.

NMDeviceInterfaceFlags

## enum NMClientPermission

NMClientPermission values indicate various permissions that NetworkManager clients can obtain to perform certain tasks on behalf of the current user.

### Values

NM_CLIENT_PERMISSION_NONE | = `0` | unknown or no permission
NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK | = `1` | controls whether networking can be globally enabled or disabled
NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI | = `2` | controls whether Wi-Fi can be globally enabled or disabled
NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN | = `3` | controls whether WWAN (3G) can be globally enabled or disabled
NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX | = `4` | controls whether WiMAX can be globally enabled or disabled
NM_CLIENT_PERMISSION_SLEEP_WAKE | = `5` | controls whether the client can ask NetworkManager to sleep and wake
NM_CLIENT_PERMISSION_NETWORK_CONTROL | = `6` | controls whether networking connections can be started, stopped, and changed
NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED | = `7` | controls whether a password protected Wi-Fi hotspot can be created
NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN | = `8` | controls whether an open Wi-Fi hotspot can be created
NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM | = `9` | controls whether connections that are available to all users can be modified
NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN | = `10` | controls whether connections owned by the current user can be modified
NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME | = `11` | controls whether the persistent hostname can be changed
NM_CLIENT_PERMISSION_SETTINGS_MODIFY_GLOBAL_DNS | = `12` | modify persistent global DNS configuration
NM_CLIENT_PERMISSION_RELOAD | = `13` | controls access to Reload.
NM_CLIENT_PERMISSION_CHECKPOINT_ROLLBACK | = `14` | permission to create checkpoints.
NM_CLIENT_PERMISSION_ENABLE_DISABLE_STATISTICS | = `15` | controls whether device statistics can be globally enabled or disabled
NM_CLIENT_PERMISSION_ENABLE_DISABLE_CONNECTIVITY_CHECK | = `16` | controls whether connectivity check can be enabled or disabled
NM_CLIENT_PERMISSION_WIFI_SCAN | = `17` | controls whether wifi scans can be performed

NMClientPermission

## enum NMClientPermissionResult

NMClientPermissionResult values indicate what authorizations and permissions the user requires to obtain a given NMClientPermission

### Values

NM_CLIENT_PERMISSION_RESULT_UNKNOWN | = `0` | unknown or no authorization
NM_CLIENT_PERMISSION_RESULT_YES | = `1` | the permission is available
NM_CLIENT_PERMISSION_RESULT_AUTH | = `2` | authorization is necessary before the permission is available
NM_CLIENT_PERMISSION_RESULT_NO | = `3` | permission to perform the operation is denied by system policy

NMClientPermissionResult