Top |
Types and Values
Object Hierarchy
GEnum ├── NM80211Mode ├── NMActiveConnectionState ├── NMActiveConnectionStateReason ├── NMCapability ├── NMConnectivityState ├── NMDeviceState ├── NMDeviceStateReason ├── NMDeviceType ├── NMIPTunnelMode ├── NMMetered ├── NMState ╰── NMWimaxNspNetworkType GFlags ├── NM80211ApFlags ├── NM80211ApSecurityFlags ├── NMActivationStateFlags ├── NMBluetoothCapabilities ├── NMDeviceCapabilities ├── NMDeviceModemCapabilities ├── NMDeviceWifiCapabilities ├── NMSecretAgentCapabilities ├── NMSecretAgentGetSecretsFlags ╰── NMSettingsUpdate2Flags
Types and Values
NM_DBUS_INTERFACE_DEVICE_WIRED
#define NM_DBUS_INTERFACE_DEVICE_WIRED NM_DBUS_INTERFACE_DEVICE ".Wired"
NM_DBUS_INTERFACE_DEVICE_ADSL
#define NM_DBUS_INTERFACE_DEVICE_ADSL NM_DBUS_INTERFACE_DEVICE ".Adsl"
NM_DBUS_INTERFACE_DEVICE_WIRELESS
#define NM_DBUS_INTERFACE_DEVICE_WIRELESS NM_DBUS_INTERFACE_DEVICE ".Wireless"
NM_DBUS_INTERFACE_DEVICE_BLUETOOTH
#define NM_DBUS_INTERFACE_DEVICE_BLUETOOTH NM_DBUS_INTERFACE_DEVICE ".Bluetooth"
NM_DBUS_INTERFACE_DEVICE_OLPC_MESH
#define NM_DBUS_INTERFACE_DEVICE_OLPC_MESH NM_DBUS_INTERFACE_DEVICE ".OlpcMesh"
NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE
#define NM_DBUS_INTERFACE_DEVICE_OVS_INTERFACE NM_DBUS_INTERFACE_DEVICE ".OvsInterface"
NM_DBUS_INTERFACE_DEVICE_OVS_PORT
#define NM_DBUS_INTERFACE_DEVICE_OVS_PORT NM_DBUS_INTERFACE_DEVICE ".OvsPort"
NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE
#define NM_DBUS_INTERFACE_DEVICE_OVS_BRIDGE NM_DBUS_INTERFACE_DEVICE ".OvsBridge"
NM_DBUS_INTERFACE_ACCESS_POINT
#define NM_DBUS_INTERFACE_ACCESS_POINT NM_DBUS_INTERFACE ".AccessPoint"
NM_DBUS_INTERFACE_DEVICE_MODEM
#define NM_DBUS_INTERFACE_DEVICE_MODEM NM_DBUS_INTERFACE_DEVICE ".Modem"
NM_DBUS_INTERFACE_DEVICE_WIMAX
#define NM_DBUS_INTERFACE_DEVICE_WIMAX NM_DBUS_INTERFACE_DEVICE ".WiMax"
NM_DBUS_INTERFACE_ACTIVE_CONNECTION
#define NM_DBUS_INTERFACE_ACTIVE_CONNECTION NM_DBUS_INTERFACE ".Connection.Active"
NM_DBUS_INTERFACE_DHCP4_CONFIG
#define NM_DBUS_INTERFACE_DHCP4_CONFIG NM_DBUS_INTERFACE ".DHCP4Config"
NM_DBUS_INTERFACE_DHCP6_CONFIG
#define NM_DBUS_INTERFACE_DHCP6_CONFIG NM_DBUS_INTERFACE ".DHCP6Config"
NM_DBUS_INTERFACE_DEVICE_INFINIBAND
#define NM_DBUS_INTERFACE_DEVICE_INFINIBAND NM_DBUS_INTERFACE_DEVICE ".Infiniband"
NM_DBUS_INTERFACE_DEVICE_BOND
#define NM_DBUS_INTERFACE_DEVICE_BOND NM_DBUS_INTERFACE_DEVICE ".Bond"
NM_DBUS_INTERFACE_DEVICE_DUMMY
#define NM_DBUS_INTERFACE_DEVICE_DUMMY NM_DBUS_INTERFACE_DEVICE ".Dummy"
NM_DBUS_INTERFACE_DEVICE_TEAM
#define NM_DBUS_INTERFACE_DEVICE_TEAM NM_DBUS_INTERFACE_DEVICE ".Team"
NM_DBUS_INTERFACE_DEVICE_VLAN
#define NM_DBUS_INTERFACE_DEVICE_VLAN NM_DBUS_INTERFACE_DEVICE ".Vlan"
NM_DBUS_INTERFACE_DEVICE_BRIDGE
#define NM_DBUS_INTERFACE_DEVICE_BRIDGE NM_DBUS_INTERFACE_DEVICE ".Bridge"
NM_DBUS_INTERFACE_DEVICE_GENERIC
#define NM_DBUS_INTERFACE_DEVICE_GENERIC NM_DBUS_INTERFACE_DEVICE ".Generic"
NM_DBUS_INTERFACE_DEVICE_VETH
#define NM_DBUS_INTERFACE_DEVICE_VETH NM_DBUS_INTERFACE_DEVICE ".Veth"
NM_DBUS_INTERFACE_DEVICE_MACSEC
#define NM_DBUS_INTERFACE_DEVICE_MACSEC NM_DBUS_INTERFACE_DEVICE ".Macsec"
NM_DBUS_INTERFACE_DEVICE_MACVLAN
#define NM_DBUS_INTERFACE_DEVICE_MACVLAN NM_DBUS_INTERFACE_DEVICE ".Macvlan"
NM_DBUS_INTERFACE_DEVICE_VXLAN
#define NM_DBUS_INTERFACE_DEVICE_VXLAN NM_DBUS_INTERFACE_DEVICE ".Vxlan"
NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL
#define NM_DBUS_INTERFACE_DEVICE_IP_TUNNEL NM_DBUS_INTERFACE_DEVICE ".IPTunnel"
NM_DBUS_INTERFACE_DEVICE_STATISTICS
#define NM_DBUS_INTERFACE_DEVICE_STATISTICS NM_DBUS_INTERFACE_DEVICE ".Statistics"
NM_DBUS_INTERFACE_SETTINGS
#define NM_DBUS_INTERFACE_SETTINGS "org.freedesktop.NetworkManager.Settings"
NM_DBUS_INTERFACE_SETTINGS_CONNECTION
#define NM_DBUS_INTERFACE_SETTINGS_CONNECTION "org.freedesktop.NetworkManager.Settings.Connection"
NM_DBUS_PATH_SETTINGS_CONNECTION
#define NM_DBUS_PATH_SETTINGS_CONNECTION "/org/freedesktop/NetworkManager/Settings/Connection"
NM_DBUS_INTERFACE_SETTINGS_CONNECTION_SECRETS
#define NM_DBUS_INTERFACE_SETTINGS_CONNECTION_SECRETS "org.freedesktop.NetworkManager.Settings.Connection.Secrets"
NM_DBUS_INTERFACE_AGENT_MANAGER
#define NM_DBUS_INTERFACE_AGENT_MANAGER NM_DBUS_INTERFACE ".AgentManager"
NM_DBUS_PATH_AGENT_MANAGER
#define NM_DBUS_PATH_AGENT_MANAGER "/org/freedesktop/NetworkManager/AgentManager"
NM_DBUS_INTERFACE_SECRET_AGENT
#define NM_DBUS_INTERFACE_SECRET_AGENT NM_DBUS_INTERFACE ".SecretAgent"
NM_DBUS_PATH_SECRET_AGENT
#define NM_DBUS_PATH_SECRET_AGENT "/org/freedesktop/NetworkManager/SecretAgent"
NM_DBUS_INTERFACE_DNS_MANAGER
#define NM_DBUS_INTERFACE_DNS_MANAGER "org.freedesktop.NetworkManager.DnsManager"
NM_DBUS_PATH_DNS_MANAGER
#define NM_DBUS_PATH_DNS_MANAGER "/org/freedesktop/NetworkManager/DnsManager"
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.
enum NMState
NMState values indicate the current overall networking state.
Members
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. |
||
Networking is not enabled, the system is being suspended or resumed from suspend. |
||
There is no active network connection. The graphical shell should indicate no network connectivity and the applications should not attempt to access the network. |
||
Network connections are being cleaned up. The applications should tear down their network sessions. |
||
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. |
||
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. |
||
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. |
||
There is global IPv4 and/or IPv6 Internet connectivity This means the Internet connectivity check succeeded, the graphical shell should indicate full network connectivity. |
enum NMConnectivityState
Members
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. |
||
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. |
||
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
agains the https connections) for the purpose of authenticating to a gateway
and retrigger the connectivity check with |
||
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. |
||
The host is connected to a network, and appears to be able to reach the full Internet. |
enum NMDeviceType
NMDeviceType values indicate the type of hardware represented by a device object.
Members
unknown device |
||
a wired ethernet device |
||
an 802.11 WiFi device |
||
not used |
||
not used |
||
a Bluetooth device supporting PAN or DUN access protocols |
||
an OLPC XO mesh networking device |
||
an 802.16e Mobile WiMAX broadband device |
||
a modem supporting analog telephone, CDMA/EVDO, GSM/UMTS, or LTE network access protocols |
||
an IP-over-InfiniBand device |
||
a bond master interface |
||
an 802.1Q VLAN interface |
||
ADSL modem |
||
a bridge master interface |
||
generic support for unrecognized device types |
||
a team master interface |
||
a TUN or TAP interface |
||
a IP tunnel interface |
||
a MACVLAN interface |
||
a VXLAN interface |
||
a VETH interface |
||
a MACsec interface |
||
a dummy interface |
||
a PPP interface |
||
a OpenVSwitch interface |
||
a OpenVSwitch port |
||
a OpenVSwitch bridge |
enum NMDeviceCapabilities
General device capability flags.
enum NMDeviceWifiCapabilities
802.11 specific device encryption and authentication capabilities.
Members
device has no encryption/authentication capabilities |
||
device supports 40/64-bit WEP encryption |
||
device supports 104/128-bit WEP encryption |
||
device supports TKIP encryption |
||
device supports AES/CCMP encryption |
||
device supports WPA1 authentication |
||
device supports WPA2/RSN authentication |
||
device supports Access Point mode |
||
device supports Ad-Hoc mode |
||
device reports frequency capabilities |
||
device supports 2.4GHz frequencies |
||
device supports 5GHz frequencies |
enum NM80211ApFlags
802.11 access point flags.
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.
Members
the access point has no special security requirements |
||
40/64-bit WEP is supported for pairwise/unicast encryption |
||
104/128-bit WEP is supported for pairwise/unicast encryption |
||
TKIP is supported for pairwise/unicast encryption |
||
AES/CCMP is supported for pairwise/unicast encryption |
||
40/64-bit WEP is supported for group/broadcast encryption |
||
104/128-bit WEP is supported for group/broadcast encryption |
||
TKIP is supported for group/broadcast encryption |
||
AES/CCMP is supported for group/broadcast encryption |
||
WPA/RSN Pre-Shared Key encryption is supported |
||
802.1x authentication and key management is supported |
enum NM80211Mode
Indicates the 802.11 mode an access point or device is currently in.
Members
the device or access point mode is unknown |
||
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. |
||
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. |
||
the device is an access point/hotspot. Not valid for access point objects; used only for hotspot mode on the local machine. |
enum NMBluetoothCapabilities
NMBluetoothCapabilities values indicate the usable capabilities of a Bluetooth device.
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.
Members
modem has no usable capabilities |
||
modem uses the analog wired telephone network and is not a wireless/cellular device |
||
modem supports at least one of CDMA 1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B |
||
modem supports at least one of GSM, GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability |
||
modem has LTE data capability |
enum NMDeviceState
Members
the device's state is unknown |
||
the device is recognized, but not managed by NetworkManager |
||
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. |
||
the device can be activated, but is currently idle and not connected to a network. |
||
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. |
||
the device is connecting to the requested network. This may include operations like associating with the WiFi AP, dialing the modem, connecting to the remote Bluetooth device, etc. |
||
the device requires more information to continue connecting to the requested network. This includes secrets like WiFi passphrases, login passwords, PIN codes, etc. |
||
the device is requesting IPv4 and/or IPv6 addresses and routing information from the network. |
||
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. |
||
the device is waiting for a secondary connection (like a VPN) which must activated before the device can be activated |
||
the device has a network connection, either local or global. |
||
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. |
||
the device failed to connect to the requested network and is cleaning up the connection request |
enum NMDeviceStateReason
Device state change reason codes
Members
No reason given |
||
Unknown error |
||
Device is now managed |
||
Device is now unmanaged |
||
The device could not be readied for configuration |
||
IP configuration could not be reserved (no available address, timeout, etc) |
||
The IP config is no longer valid |
||
Secrets were required, but not provided |
||
802.1x supplicant disconnected |
||
802.1x supplicant configuration failed |
||
802.1x supplicant failed |
||
802.1x supplicant took too long to authenticate |
||
PPP service failed to start |
||
PPP service disconnected |
||
PPP failed |
||
DHCP client failed to start |
||
DHCP client error |
||
DHCP client failed |
||
Shared connection service failed to start |
||
Shared connection service failed |
||
AutoIP service failed to start |
||
AutoIP service error |
||
AutoIP service failed |
||
The line is busy |
||
No dial tone |
||
No carrier could be established |
||
The dialing request timed out |
||
The dialing attempt failed |
||
Modem initialization failed |
||
Failed to select the specified APN |
||
Not searching for networks |
||
Network registration denied |
||
Network registration timed out |
||
Failed to register with the requested network |
||
PIN check failed |
||
Necessary firmware for the device may be missing |
||
The device was removed |
||
NetworkManager went to sleep |
||
The device's active connection disappeared |
||
Device disconnected by user or client |
||
Carrier/link changed |
||
The device's existing connection was assumed |
||
The supplicant is now available |
||
The modem could not be found |
||
The Bluetooth connection failed or timed out |
||
GSM Modem's SIM Card not inserted |
||
GSM Modem's SIM Pin required |
||
GSM Modem's SIM Puk required |
||
GSM Modem's SIM wrong |
||
InfiniBand device does not support connected mode |
||
A dependency of the connection failed |
||
Problem with the RFC 2684 Ethernet over ADSL bridge |
||
ModemManager not running |
||
The WiFi network could not be found |
||
A secondary connection of the base connection failed |
||
DCB or FCoE setup failed |
||
teamd control failed |
||
Modem failed or no longer available |
||
Modem now ready and available |
||
SIM PIN was incorrect |
||
New connection activation was enqueued |
||
the device's parent changed |
||
the device parent's management changed |
||
problem communicating with OpenVSwitch database |
||
a duplicate IP address was detected |
||
The selected IP method is not supported |
enum NMActiveConnectionState
NMActiveConnectionState values indicate the state of a connection to a specific network while it is starting, connected, or disconnecting from that network.
enum NMActiveConnectionStateReason
Active connection state reasons.
Members
The reason for the active connection state change is unknown. |
||
No reason was given for the active connection state change. |
||
The active connection changed state because the user disconnected it. |
||
The active connection changed state because the device it was using was disconnected. |
||
The service providing the VPN connection was stopped. |
||
The IP config of the active connection was invalid. |
||
The connection attempt to the VPN service timed out. |
||
A timeout occurred while starting the service providing the VPN connection. |
||
Starting the service providing the VPN connection failed. |
||
Necessary secrets for the connection were not provided. |
||
Authentication to the server failed. |
||
The connection was deleted from settings. |
||
Master connection of this connection failed to activate. |
||
Could not create the software device link. |
||
The device this connection depended on disappeared. |
Since: 1.8
enum NMSecretAgentGetSecretsFlags
NMSecretAgentGetSecretsFlags values modify the behavior of a GetSecrets request.
Members
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. |
||
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. |
||
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. |
||
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. |
||
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. |
||
Internal flag, not part of the D-Bus API. |
||
Internal flag, not part of the D-Bus API. |
enum NMSecretAgentCapabilities
NMSecretAgentCapabilities indicate various capabilities of the agent.
NM_LLDP_ATTR_IEEE_802_1_PPVID_FLAGS
#define NM_LLDP_ATTR_IEEE_802_1_PPVID_FLAGS "ieee-802-1-ppvid-flags"
NM_LLDP_DEST_NEAREST_NON_TPMR_BRIDGE
#define NM_LLDP_DEST_NEAREST_NON_TPMR_BRIDGE "nearest-non-tpmr-bridge"
NM_LLDP_DEST_NEAREST_CUSTOMER_BRIDGE
#define NM_LLDP_DEST_NEAREST_CUSTOMER_BRIDGE "nearest-customer-bridge"
enum NMIPTunnelMode
The tunneling mode.
Members
Unknown/unset tunnel mode |
||
IP in IP tunnel |
||
GRE tunnel |
||
SIT tunnel |
||
ISATAP tunnel |
||
VTI tunnel |
||
IPv6 in IPv6 tunnel |
||
IPv4 in IPv6 tunnel |
||
IPv6 GRE tunnel |
||
IPv6 VTI tunnel |
Since: 1.2
enum NMCheckpointCreateFlags
The flags for CheckpointCreate call
Members
no flags |
||
when creating a new checkpoint, destroy all existing ones. |
||
upon rollback, delete any new connection added after the checkpoint (Since: 1.6) |
||
upon rollback, disconnect any new device appeared after the checkpoint (Since: 1.6) |
Since: 1.4
enum NMRollbackResult
The result of a checkpoint Rollback()
operation for a specific device.
Since: 1.4
enum NMActivationStateFlags
Flags describing the current activation state.
Members
an alias for numeric zero, no flags set. |
||
the device is a master. |
||
the device is a slave. |
||
layer2 is activated and ready. |
||
IPv4 setting is completed. |
||
IPv6 setting is completed. |
||
The master has any slave devices attached. This only makes sense if the device is a master. |
Since: 1.10
enum NMSettingsUpdate2Flags
Members
an alias for numeric zero, no flags set. |
||
to persist the connection to disk. |
||
to make the connection in-memory only. If the connection was previously persistent, the corresponding file on disk is not deleted but merely the connection is decoupled from the file on disk. If you later delete an in-memory connection, the connection on disk will be deleted as well. |
||
this is like |
||
this is like |
||
This can be specified with either
|
||
usually, when the connection has autoconnect enabled and is modified, it becomes elegible to autoconnect right away. Setting this flag, disables autoconnect until the connection is manually activated. |
Since: 1.10.2