<?xml version='1.0'?>
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<refentry id="nm-dbus-types">
<refmeta>
<refentrytitle role="top_of_page" id="nm-dbus-types.top_of_page">NetworkManager D-Bus API Types</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>NetworkManager D-Bus API Types</refmiscinfo>
</refmeta>
<refnamediv>
<refname>NetworkManager D-Bus API Types</refname>
<refpurpose></refpurpose>
</refnamediv>
<refsect2 id="NMCapability" role="enum">
<title>enum NMCapability</title>
<indexterm zone="NMCapability">
<primary>NMCapability</primary>
</indexterm>
<para><para><link linkend="NMCapability">NMCapability</link> 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.</para><para>The range 0x7000 - 0x7FFF of capabilities is guaranteed not to be used by upstream NetworkManager. It could thus be used for downstream extensions.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CAPABILITY_TEAM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Teams can be managed. This means the team device plugin is loaded.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CAPABILITY_OVS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>OpenVSwitch can be managed. This means the OVS device plugin is loaded. Since: 1.24.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMState" role="enum">
<title>enum NMState</title>
<indexterm zone="NMState">
<primary>NMState</primary>
</indexterm>
<para><para><link linkend="NMState">NMState</link> values indicate the current overall networking state.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_ASLEEP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Networking is not enabled, the system is being suspended or resumed from suspend.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_DISCONNECTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>There is no active network connection. The graphical shell should indicate no network connectivity and the applications should not attempt to access the network.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_DISCONNECTING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>30</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Network connections are being cleaned up. The applications should tear down their network sessions.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_CONNECTING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>40</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_CONNECTED_LOCAL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>50</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_CONNECTED_SITE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>60</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_STATE_CONNECTED_GLOBAL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>70</literal></para><para></para></entry>
<entry role="enum_member_description"><para>There is global IPv4 and/or IPv6 Internet connectivity This means the Internet connectivity check succeeded, the graphical shell should indicate full network connectivity.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMConnectivityState" role="enum">
<title>enum NMConnectivityState</title>
<indexterm zone="NMConnectivityState">
<primary>NMConnectivityState</primary>
</indexterm>
<para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTIVITY_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTIVITY_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTIVITY_PORTAL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTIVITY_LIMITED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTIVITY_FULL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The host is connected to a network, and appears to be able to reach the full Internet.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceType" role="enum">
<title>enum NMDeviceType</title>
<indexterm zone="NMDeviceType">
<primary>NMDeviceType</primary>
</indexterm>
<para><para><link linkend="NMDeviceType">NMDeviceType</link> values indicate the type of hardware represented by a device object.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>unknown device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_GENERIC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>14</literal></para><para></para></entry>
<entry role="enum_member_description"><para>generic support for unrecognized device types</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_ETHERNET</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a wired ethernet device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_WIFI</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an 802.11 Wi-Fi device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_UNUSED1</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>not used</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_UNUSED2</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>not used</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_BT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>5</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a Bluetooth device supporting PAN or DUN access protocols</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_OLPC_MESH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>6</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an OLPC XO mesh networking device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_WIMAX</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an 802.16e Mobile WiMAX broadband device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_MODEM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a modem supporting analog telephone, CDMA/EVDO, GSM/UMTS, or LTE network access protocols</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_INFINIBAND</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>9</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an IP-over-InfiniBand device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_BOND</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a bond master interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_VLAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>11</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an 802.1Q VLAN interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_ADSL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>12</literal></para><para></para></entry>
<entry role="enum_member_description"><para>ADSL modem</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_BRIDGE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>13</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a bridge master interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_TEAM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>15</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a team master interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_TUN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>16</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a TUN or TAP interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_IP_TUNNEL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>17</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a IP tunnel interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_MACVLAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>18</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a MACVLAN interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_VXLAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>19</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a VXLAN interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_VETH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a VETH interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_MACSEC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>21</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a MACsec interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_DUMMY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>22</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a dummy interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_PPP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>23</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a PPP interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_OVS_INTERFACE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>24</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a Open vSwitch interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_OVS_PORT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>25</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a Open vSwitch port</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_OVS_BRIDGE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>26</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a Open vSwitch bridge</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_WPAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>27</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a IEEE 802.15.4 (WPAN) MAC Layer Device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_6LOWPAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>28</literal></para><para></para></entry>
<entry role="enum_member_description"><para>6LoWPAN interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_WIREGUARD</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>29</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a WireGuard interface</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_WIFI_P2P</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>30</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an 802.11 Wi-Fi P2P device. Since: 1.16.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_TYPE_VRF</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>31</literal></para><para></para></entry>
<entry role="enum_member_description"><para>A VRF (Virtual Routing and Forwarding) interface. Since: 1.24.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceCapabilities" role="enum">
<title>enum NMDeviceCapabilities</title>
<indexterm zone="NMDeviceCapabilities">
<primary>NMDeviceCapabilities</primary>
</indexterm>
<para><para>General device capability flags.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_CAP_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device has no special capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_CAP_NM_SUPPORTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>NetworkManager supports this device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_CAP_CARRIER_DETECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>this device can indicate carrier status</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_CAP_IS_SOFTWARE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000004</literal></para><para></para></entry>
<entry role="enum_member_description"><para>this device is a software device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_CAP_SRIOV</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000008</literal></para><para></para></entry>
<entry role="enum_member_description"><para>this device supports single-root I/O virtualization</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceWifiCapabilities" role="enum">
<title>enum NMDeviceWifiCapabilities</title>
<indexterm zone="NMDeviceWifiCapabilities">
<primary>NMDeviceWifiCapabilities</primary>
</indexterm>
<para><para>802.11 specific device encryption and authentication capabilities.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device has no encryption/authentication capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_CIPHER_WEP40</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports 40/64-bit WEP encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_CIPHER_WEP104</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports 104/128-bit WEP encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_CIPHER_TKIP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000004</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports TKIP encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_CIPHER_CCMP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000008</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports AES/CCMP encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_WPA</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000010</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports WPA1 authentication</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_RSN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000020</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports WPA2/RSN authentication</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_AP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000040</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports Access Point mode</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_ADHOC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000080</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports Ad-Hoc mode</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_FREQ_VALID</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000100</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device reports frequency capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_FREQ_2GHZ</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000200</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports 2.4GHz frequencies</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_FREQ_5GHZ</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000400</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports 5GHz frequencies</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_MESH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00001000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports acting as a mesh point. Since: 1.20.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIFI_DEVICE_CAP_IBSS_RSN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00002000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device supports WPA2/RSN in an IBSS network. Since: 1.22.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NM80211ApFlags" role="enum">
<title>enum NM80211ApFlags</title>
<indexterm zone="NM80211ApFlags">
<primary>NM80211ApFlags</primary>
</indexterm>
<para><para>802.11 access point flags.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_FLAGS_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>access point has no special capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_FLAGS_PRIVACY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>access point requires authentication and encryption (usually means WEP)</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_FLAGS_WPS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>access point supports some WPS method</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_FLAGS_WPS_PBC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000004</literal></para><para></para></entry>
<entry role="enum_member_description"><para>access point supports push-button WPS</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_FLAGS_WPS_PIN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000008</literal></para><para></para></entry>
<entry role="enum_member_description"><para>access point supports PIN-based WPS</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NM80211ApSecurityFlags" role="enum">
<title>enum NM80211ApSecurityFlags</title>
<indexterm zone="NM80211ApSecurityFlags">
<primary>NM80211ApSecurityFlags</primary>
</indexterm>
<para><para>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.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the access point has no special security requirements</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_PAIR_WEP40</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>40/64-bit WEP is supported for pairwise/unicast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_PAIR_WEP104</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>104/128-bit WEP is supported for pairwise/unicast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_PAIR_TKIP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000004</literal></para><para></para></entry>
<entry role="enum_member_description"><para>TKIP is supported for pairwise/unicast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_PAIR_CCMP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000008</literal></para><para></para></entry>
<entry role="enum_member_description"><para>AES/CCMP is supported for pairwise/unicast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_GROUP_WEP40</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000010</literal></para><para></para></entry>
<entry role="enum_member_description"><para>40/64-bit WEP is supported for group/broadcast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_GROUP_WEP104</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000020</literal></para><para></para></entry>
<entry role="enum_member_description"><para>104/128-bit WEP is supported for group/broadcast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_GROUP_TKIP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000040</literal></para><para></para></entry>
<entry role="enum_member_description"><para>TKIP is supported for group/broadcast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_GROUP_CCMP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000080</literal></para><para></para></entry>
<entry role="enum_member_description"><para>AES/CCMP is supported for group/broadcast encryption</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_PSK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000100</literal></para><para></para></entry>
<entry role="enum_member_description"><para>WPA/RSN Pre-Shared Key encryption is supported</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_802_1X</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000200</literal></para><para></para></entry>
<entry role="enum_member_description"><para>802.1x authentication and key management is supported</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_SAE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000400</literal></para><para></para></entry>
<entry role="enum_member_description"><para>WPA/RSN Simultaneous Authentication of Equals is supported</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_OWE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000800</literal></para><para></para></entry>
<entry role="enum_member_description"><para>WPA/RSN Opportunistic Wireless Encryption is supported</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_OWE_TM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00001000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>WPA/RSN Opportunistic Wireless Encryption transition mode is supported. Since: 1.26.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_AP_SEC_KEY_MGMT_EAP_SUITE_B_192</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00002000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>WPA3 Enterprise Suite-B 192 bit mode is supported. Since: 1.30.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NM80211Mode" role="enum">
<title>enum NM80211Mode</title>
<indexterm zone="NM80211Mode">
<primary>NM80211Mode</primary>
</indexterm>
<para><para>Indicates the 802.11 mode an access point or device is currently in.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_MODE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device or access point mode is unknown</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_MODE_ADHOC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_MODE_INFRA</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_MODE_AP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is an access point/hotspot. Not valid for access point objects; used only for hotspot mode on the local machine.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_802_11_MODE_MESH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is a 802.11s mesh point. Since: 1.20.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMBluetoothCapabilities" role="enum">
<title>enum NMBluetoothCapabilities</title>
<indexterm zone="NMBluetoothCapabilities">
<primary>NMBluetoothCapabilities</primary>
</indexterm>
<para><para><link linkend="NMBluetoothCapabilities">NMBluetoothCapabilities</link> values indicate the usable capabilities of a Bluetooth device.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_BT_CAPABILITY_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device has no usable capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_BT_CAPABILITY_DUN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device provides Dial-Up Networking capability</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_BT_CAPABILITY_NAP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>device provides Network Access Point capability</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceModemCapabilities" role="enum">
<title>enum NMDeviceModemCapabilities</title>
<indexterm zone="NMDeviceModemCapabilities">
<primary>NMDeviceModemCapabilities</primary>
</indexterm>
<para><para><link linkend="NMDeviceModemCapabilities">NMDeviceModemCapabilities</link> 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.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_MODEM_CAPABILITY_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modem has no usable capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_MODEM_CAPABILITY_POTS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000001</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modem uses the analog wired telephone network and is not a wireless/cellular device</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_MODEM_CAPABILITY_CDMA_EVDO</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000002</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modem supports at least one of CDMA 1xRTT, EVDO revision 0, EVDO revision A, or EVDO revision B</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_MODEM_CAPABILITY_GSM_UMTS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000004</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modem supports at least one of GSM, GPRS, EDGE, UMTS, HSDPA, HSUPA, or HSPA+ packet switched data capability</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_MODEM_CAPABILITY_LTE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x00000008</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modem has LTE data capability</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMWimaxNspNetworkType" role="enum">
<title>enum NMWimaxNspNetworkType</title>
<indexterm zone="NMWimaxNspNetworkType">
<primary>NMWimaxNspNetworkType</primary>
</indexterm>
<para><para>WiMAX network type.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIMAX_NSP_NETWORK_TYPE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>unknown network type</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIMAX_NSP_NETWORK_TYPE_HOME</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>home network</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIMAX_NSP_NETWORK_TYPE_PARTNER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>partner network</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_WIMAX_NSP_NETWORK_TYPE_ROAMING_PARTNER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>roaming partner network</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceState" role="enum">
<title>enum NMDeviceState</title>
<indexterm zone="NMDeviceState">
<primary>NMDeviceState</primary>
</indexterm>
<para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device's state is unknown</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_UNMANAGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is recognized, but not managed by NetworkManager</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_UNAVAILABLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_DISCONNECTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>30</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device can be activated, but is currently idle and not connected to a network.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_PREPARE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>40</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_CONFIG</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>50</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_NEED_AUTH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>60</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device requires more information to continue connecting to the requested network. This includes secrets like WiFi passphrases, login passwords, PIN codes, etc.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_IP_CONFIG</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>70</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is requesting IPv4 and/or IPv6 addresses and routing information from the network.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_IP_CHECK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>80</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_SECONDARIES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>90</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is waiting for a secondary connection (like a VPN) which must activated before the device can be activated</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_ACTIVATED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>100</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device has a network connection, either local or global.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_DEACTIVATING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>110</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>120</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device failed to connect to the requested network and is cleaning up the connection request</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceStateReason" role="enum">
<title>enum NMDeviceStateReason</title>
<indexterm zone="NMDeviceStateReason">
<primary>NMDeviceStateReason</primary>
</indexterm>
<para><para>Device state change reason codes</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>No reason given</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Unknown error</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_NOW_MANAGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Device is now managed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_NOW_UNMANAGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Device is now unmanaged</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_CONFIG_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The device could not be readied for configuration</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_IP_CONFIG_UNAVAILABLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>5</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IP configuration could not be reserved (no available address, timeout, etc)</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_IP_CONFIG_EXPIRED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>6</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The IP config is no longer valid</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_NO_SECRETS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Secrets were required, but not provided</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SUPPLICANT_DISCONNECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>802.1x supplicant disconnected</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SUPPLICANT_CONFIG_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>9</literal></para><para></para></entry>
<entry role="enum_member_description"><para>802.1x supplicant configuration failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SUPPLICANT_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>802.1x supplicant failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SUPPLICANT_TIMEOUT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>11</literal></para><para></para></entry>
<entry role="enum_member_description"><para>802.1x supplicant took too long to authenticate</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PPP_START_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>12</literal></para><para></para></entry>
<entry role="enum_member_description"><para>PPP service failed to start</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PPP_DISCONNECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>13</literal></para><para></para></entry>
<entry role="enum_member_description"><para>PPP service disconnected</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PPP_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>14</literal></para><para></para></entry>
<entry role="enum_member_description"><para>PPP failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_DHCP_START_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>15</literal></para><para></para></entry>
<entry role="enum_member_description"><para>DHCP client failed to start</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_DHCP_ERROR</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>16</literal></para><para></para></entry>
<entry role="enum_member_description"><para>DHCP client error</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_DHCP_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>17</literal></para><para></para></entry>
<entry role="enum_member_description"><para>DHCP client failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SHARED_START_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>18</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Shared connection service failed to start</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SHARED_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>19</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Shared connection service failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_AUTOIP_START_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>AutoIP service failed to start</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_AUTOIP_ERROR</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>21</literal></para><para></para></entry>
<entry role="enum_member_description"><para>AutoIP service error</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_AUTOIP_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>22</literal></para><para></para></entry>
<entry role="enum_member_description"><para>AutoIP service failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_BUSY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>23</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The line is busy</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_NO_DIAL_TONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>24</literal></para><para></para></entry>
<entry role="enum_member_description"><para>No dial tone</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_NO_CARRIER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>25</literal></para><para></para></entry>
<entry role="enum_member_description"><para>No carrier could be established</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_DIAL_TIMEOUT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>26</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The dialing request timed out</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_DIAL_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>27</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The dialing attempt failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_INIT_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>28</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Modem initialization failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_APN_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>29</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Failed to select the specified APN</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_REGISTRATION_NOT_SEARCHING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>30</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Not searching for networks</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_REGISTRATION_DENIED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>31</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Network registration denied</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_REGISTRATION_TIMEOUT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>32</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Network registration timed out</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_REGISTRATION_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>33</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Failed to register with the requested network</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_PIN_CHECK_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>34</literal></para><para></para></entry>
<entry role="enum_member_description"><para>PIN check failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_FIRMWARE_MISSING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>35</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Necessary firmware for the device may be missing</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_REMOVED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>36</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The device was removed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SLEEPING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>37</literal></para><para></para></entry>
<entry role="enum_member_description"><para>NetworkManager went to sleep</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_CONNECTION_REMOVED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>38</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The device's active connection disappeared</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_USER_REQUESTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>39</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Device disconnected by user or client</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_CARRIER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>40</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Carrier/link changed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_CONNECTION_ASSUMED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>41</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The device's existing connection was assumed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SUPPLICANT_AVAILABLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>42</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The supplicant is now available</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_NOT_FOUND</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>43</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The modem could not be found</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_BT_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>44</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The Bluetooth connection failed or timed out</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_SIM_NOT_INSERTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>45</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GSM Modem's SIM Card not inserted</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_SIM_PIN_REQUIRED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>46</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GSM Modem's SIM Pin required</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_SIM_PUK_REQUIRED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>47</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GSM Modem's SIM Puk required</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_GSM_SIM_WRONG</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>48</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GSM Modem's SIM wrong</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_INFINIBAND_MODE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>49</literal></para><para></para></entry>
<entry role="enum_member_description"><para>InfiniBand device does not support connected mode</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_DEPENDENCY_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>50</literal></para><para></para></entry>
<entry role="enum_member_description"><para>A dependency of the connection failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_BR2684_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>51</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Problem with the RFC 2684 Ethernet over ADSL bridge</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_MANAGER_UNAVAILABLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>52</literal></para><para></para></entry>
<entry role="enum_member_description"><para>ModemManager not running</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SSID_NOT_FOUND</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>53</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The Wi-Fi network could not be found</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SECONDARY_CONNECTION_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>54</literal></para><para></para></entry>
<entry role="enum_member_description"><para>A secondary connection of the base connection failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_DCB_FCOE_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>55</literal></para><para></para></entry>
<entry role="enum_member_description"><para>DCB or FCoE setup failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_TEAMD_CONTROL_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>56</literal></para><para></para></entry>
<entry role="enum_member_description"><para>teamd control failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>57</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Modem failed or no longer available</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_MODEM_AVAILABLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>58</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Modem now ready and available</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SIM_PIN_INCORRECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>59</literal></para><para></para></entry>
<entry role="enum_member_description"><para>SIM PIN was incorrect</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_NEW_ACTIVATION</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>60</literal></para><para></para></entry>
<entry role="enum_member_description"><para>New connection activation was enqueued</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PARENT_CHANGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>61</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device's parent changed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PARENT_MANAGED_CHANGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>62</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device parent's management changed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_OVSDB_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>63</literal></para><para></para></entry>
<entry role="enum_member_description"><para>problem communicating with Open vSwitch database</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_IP_ADDRESS_DUPLICATE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>64</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a duplicate IP address was detected</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_IP_METHOD_UNSUPPORTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>65</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The selected IP method is not supported</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_SRIOV_CONFIGURATION_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>66</literal></para><para></para></entry>
<entry role="enum_member_description"><para>configuration of SR-IOV parameters failed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_STATE_REASON_PEER_NOT_FOUND</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>67</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The Wi-Fi P2P peer could not be found</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMMetered" role="enum">
<title>enum NMMetered</title>
<indexterm zone="NMMetered">
<primary>NMMetered</primary>
</indexterm>
<para><para>The NMMetered enum has two different purposes: one is to configure "connection.metered" setting of a connection profile in <link linkend="NMSettingConnection,">NMSettingConnection,</link> and the other is to express the actual metered state of the <link linkend="NMDevice">NMDevice</link> at a given moment.</para><para>For the connection profile only <link linkend="NM_METERED_UNKNOWN,">NM_METERED_UNKNOWN,</link> <link linkend="NM_METERED_NO">NM_METERED_NO</link> and <link linkend="NM_METERED_YES">NM_METERED_YES</link> are allowed.</para><para>The device's metered state at runtime is determined by the profile which is currently active. If the profile explicitly specifies <link linkend="NM_METERED_NO">NM_METERED_NO</link> or <link linkend="NM_METERED_YES,">NM_METERED_YES,</link> then the device's metered state is as such. If the connection profile leaves it undecided at <link linkend="NM_METERED_UNKNOWN">NM_METERED_UNKNOWN</link> (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 <link linkend="NM_METERED_GUESS_NO">NM_METERED_GUESS_NO</link> or <link linkend="NM_METERED_GUESS_YES">NM_METERED_GUESS_YES</link>.</para><para>Most applications probably should treat the runtime state <link linkend="NM_METERED_GUESS_YES">NM_METERED_GUESS_YES</link> like <link linkend="NM_METERED_YES,">NM_METERED_YES,</link> and all other states as not metered.</para><para>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.</para><para>Since: 1.2</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_METERED_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The metered status is unknown</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_METERED_YES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Metered, the value was explicitly configured</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_METERED_NO</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Not metered, the value was explicitly configured</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_METERED_GUESS_YES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Metered, the value was guessed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_METERED_GUESS_NO</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Not metered, the value was guessed</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMConnectionMultiConnect" role="enum">
<title>enum NMConnectionMultiConnect</title>
<indexterm zone="NMConnectionMultiConnect">
<primary>NMConnectionMultiConnect</primary>
</indexterm>
<para><para>Since: 1.14</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTION_MULTI_CONNECT_DEFAULT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTION_MULTI_CONNECT_SINGLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the connection profile can only be active once at each moment. Activating a profile that is already active, will first deactivate it.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTION_MULTI_CONNECT_MANUAL_MULTIPLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CONNECTION_MULTI_CONNECT_MULTIPLE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the profile can autoactivate and be manually activated multiple times together.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMActiveConnectionState" role="enum">
<title>enum NMActiveConnectionState</title>
<indexterm zone="NMActiveConnectionState">
<primary>NMActiveConnectionState</primary>
</indexterm>
<para><para><link linkend="NMActiveConnectionState">NMActiveConnectionState</link> values indicate the state of a connection to a specific network while it is starting, connected, or disconnecting from that network.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the state of the connection is unknown</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_ACTIVATING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>a network connection is being prepared</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_ACTIVATED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>there is a connection to the network</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_DEACTIVATING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the network connection is being torn down and cleaned up</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_DEACTIVATED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the network connection is disconnected and will be removed</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMActiveConnectionStateReason" role="enum">
<title>enum NMActiveConnectionStateReason</title>
<indexterm zone="NMActiveConnectionStateReason">
<primary>NMActiveConnectionStateReason</primary>
</indexterm>
<para><para>Active connection state reasons.</para><para>Since: 1.8</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The reason for the active connection state change is unknown.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>No reason was given for the active connection state change.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_USER_DISCONNECTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The active connection changed state because the user disconnected it.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_DISCONNECTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The active connection changed state because the device it was using was disconnected.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_STOPPED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The service providing the VPN connection was stopped.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_IP_CONFIG_INVALID</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>5</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The IP config of the active connection was invalid.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_CONNECT_TIMEOUT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>6</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The connection attempt to the VPN service timed out.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_START_TIMEOUT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>A timeout occurred while starting the service providing the VPN connection.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_SERVICE_START_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Starting the service providing the VPN connection failed.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_NO_SECRETS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>9</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Necessary secrets for the connection were not provided.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_LOGIN_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Authentication to the server failed.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_CONNECTION_REMOVED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>11</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The connection was deleted from settings.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_DEPENDENCY_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>12</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Master connection of this connection failed to activate.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_REALIZE_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>13</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Could not create the software device link.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVE_CONNECTION_STATE_REASON_DEVICE_REMOVED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>14</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The device this connection depended on disappeared.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMSecretAgentGetSecretsFlags" role="enum">
<title>enum NMSecretAgentGetSecretsFlags</title>
<indexterm zone="NMSecretAgentGetSecretsFlags">
<primary>NMSecretAgentGetSecretsFlags</primary>
</indexterm>
<para><para><link linkend="NMSecretAgentGetSecretsFlags">NMSecretAgentGetSecretsFlags</link> values modify the behavior of a GetSecrets request.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_ALLOW_INTERACTION</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_REQUEST_NEW</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_USER_REQUESTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_WPS_PBC_ACTIVE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_ONLY_SYSTEM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x80000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Internal flag, not part of the D-Bus API.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_GET_SECRETS_FLAG_NO_ERRORS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x40000000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Internal flag, not part of the D-Bus API.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMSecretAgentCapabilities" role="enum">
<title>enum NMSecretAgentCapabilities</title>
<indexterm zone="NMSecretAgentCapabilities">
<primary>NMSecretAgentCapabilities</primary>
</indexterm>
<para><para><link linkend="NMSecretAgentCapabilities">NMSecretAgentCapabilities</link> indicate various capabilities of the agent.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_CAPABILITY_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the agent supports no special capabilities</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SECRET_AGENT_CAPABILITY_VPN_HINTS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the agent supports passing hints to VPN plugin authentication dialogs.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMIPTunnelMode" role="enum">
<title>enum NMIPTunnelMode</title>
<indexterm zone="NMIPTunnelMode">
<primary>NMIPTunnelMode</primary>
</indexterm>
<para><para>The tunneling mode.</para><para>Since: 1.2</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>Unknown/unset tunnel mode</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_IPIP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IP in IP tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_GRE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GRE tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_SIT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>SIT tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_ISATAP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>ISATAP tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_VTI</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>5</literal></para><para></para></entry>
<entry role="enum_member_description"><para>VTI tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_IP6IP6</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>6</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv6 in IPv6 tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_IPIP6</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv4 in IPv6 tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_IP6GRE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv6 GRE tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_VTI6</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>9</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv6 VTI tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_GRETAP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>GRETAP tunnel</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_IP_TUNNEL_MODE_IP6GRETAP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>11</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv6 GRETAP tunnel</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMCheckpointCreateFlags" role="enum">
<title>enum NMCheckpointCreateFlags</title>
<indexterm zone="NMCheckpointCreateFlags">
<primary>NMCheckpointCreateFlags</primary>
</indexterm>
<para><para>The flags for CheckpointCreate call</para><para>Since: 1.4 (gi flags generated since 1.12)</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CHECKPOINT_CREATE_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>no flags</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CHECKPOINT_CREATE_FLAG_DESTROY_ALL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x01</literal></para><para></para></entry>
<entry role="enum_member_description"><para>when creating a new checkpoint, destroy all existing ones.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CHECKPOINT_CREATE_FLAG_DELETE_NEW_CONNECTIONS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x02</literal></para><para></para></entry>
<entry role="enum_member_description"><para>upon rollback, delete any new connection added after the checkpoint. Since: 1.6.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CHECKPOINT_CREATE_FLAG_DISCONNECT_NEW_DEVICES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x04</literal></para><para></para></entry>
<entry role="enum_member_description"><para>upon rollback, disconnect any new device appeared after the checkpoint. Since: 1.6.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CHECKPOINT_CREATE_FLAG_ALLOW_OVERLAPPING</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x08</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMRollbackResult" role="enum">
<title>enum NMRollbackResult</title>
<indexterm zone="NMRollbackResult">
<primary>NMRollbackResult</primary>
</indexterm>
<para><para>The result of a checkpoint Rollback() operation for a specific device.</para><para>Since: 1.4</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_ROLLBACK_RESULT_OK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the rollback succeeded.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ROLLBACK_RESULT_ERR_NO_DEVICE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device no longer exists.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ROLLBACK_RESULT_ERR_DEVICE_UNMANAGED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is now unmanaged.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ROLLBACK_RESULT_ERR_FAILED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>other errors during rollback.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMSettingsConnectionFlags" role="enum">
<title>enum NMSettingsConnectionFlags</title>
<indexterm zone="NMSettingsConnectionFlags">
<primary>NMSettingsConnectionFlags</primary>
</indexterm>
<para><para>Flags describing the current activation state.</para><para>Since: 1.12</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_CONNECTION_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_CONNECTION_FLAG_UNSAVED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x01</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_CONNECTION_FLAG_NM_GENERATED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x02</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_CONNECTION_FLAG_VOLATILE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x04</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_CONNECTION_FLAG_EXTERNAL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x08</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the profile was generated to represent an external configuration of a networking device. Since: 1.26.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMActivationStateFlags" role="enum">
<title>enum NMActivationStateFlags</title>
<indexterm zone="NMActivationStateFlags">
<primary>NMActivationStateFlags</primary>
</indexterm>
<para><para>Flags describing the current activation state.</para><para>Since: 1.10</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_IS_MASTER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is a master.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_IS_SLAVE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the device is a slave.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_LAYER2_READY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>layer2 is activated and ready.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_IP4_READY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv4 setting is completed.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_IP6_READY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>IPv6 setting is completed.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_MASTER_HAS_SLAVES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>The master has any slave devices attached. This only makes sense if the device is a master.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_LIFETIME_BOUND_TO_PROFILE_VISIBILITY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x40</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_ACTIVATION_STATE_FLAG_EXTERNAL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x80</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the active connection was generated to represent an external configuration of a networking device. Since: 1.26.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMSettingsAddConnection2Flags" role="enum">
<title>enum NMSettingsAddConnection2Flags</title>
<indexterm zone="NMSettingsAddConnection2Flags">
<primary>NMSettingsAddConnection2Flags</primary>
</indexterm>
<para><para>Numeric flags for the "flags" argument of AddConnection2() D-Bus API.</para><para>Since: 1.20</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_ADD_CONNECTION2_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_ADD_CONNECTION2_FLAG_TO_DISK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>to persist the connection to disk.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_ADD_CONNECTION2_FLAG_IN_MEMORY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>to make the connection in-memory only.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_ADD_CONNECTION2_FLAG_BLOCK_AUTOCONNECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMSettingsUpdate2Flags" role="enum">
<title>enum NMSettingsUpdate2Flags</title>
<indexterm zone="NMSettingsUpdate2Flags">
<primary>NMSettingsUpdate2Flags</primary>
</indexterm>
<para><para>Since: 1.12</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_TO_DISK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>to persist the connection to disk.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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).</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_DETACHED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_IN_MEMORY_ONLY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_VOLATILE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_BLOCK_AUTOCONNECT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x20</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_SETTINGS_UPDATE2_FLAG_NO_REAPPLY</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x40</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMTernary" role="enum">
<title>enum NMTernary</title>
<indexterm zone="NMTernary">
<primary>NMTernary</primary>
</indexterm>
<para><para>An boolean value that can be overridden by a default.</para><para>Since: 1.14</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_TERNARY_DEFAULT</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>-1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>use the globally-configured default value.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_TERNARY_FALSE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the option is disabled.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_TERNARY_TRUE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the option is enabled.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMManagerReloadFlags" role="enum">
<title>enum NMManagerReloadFlags</title>
<indexterm zone="NMManagerReloadFlags">
<primary>NMManagerReloadFlags</primary>
</indexterm>
<para><para>Flags for the manager Reload() call.</para><para>Since: 1.22</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_MANAGER_RELOAD_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set. This reloads everything that is supported and is identical to a SIGHUP.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_MANAGER_RELOAD_FLAG_CONF</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>reload the NetworkManager.conf configuration from disk. Note that this does not include connections, which can be reloaded via Setting's ReloadConnections().</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_MANAGER_RELOAD_FLAG_DNS_RC</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>update DNS configuration, which usually involves writing /etc/resolv.conf anew.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_MANAGER_RELOAD_FLAG_DNS_FULL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_MANAGER_RELOAD_FLAG_ALL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>all flags.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMDeviceInterfaceFlags" role="enum">
<title>enum NMDeviceInterfaceFlags</title>
<indexterm zone="NMDeviceInterfaceFlags">
<primary>NMDeviceInterfaceFlags</primary>
</indexterm>
<para><para>Flags for a network interface.</para><para>Since: 1.22</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_INTERFACE_FLAG_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>an alias for numeric zero, no flags set.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_INTERFACE_FLAG_UP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the interface is enabled from the administrative point of view. Corresponds to kernel IFF_UP.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_INTERFACE_FLAG_LOWER_UP</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the physical link is up. Corresponds to kernel IFF_LOWER_UP.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_DEVICE_INTERFACE_FLAG_CARRIER</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0x10000</literal></para><para></para></entry>
<entry role="enum_member_description"><para>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.</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMClientPermission" role="enum">
<title>enum NMClientPermission</title>
<indexterm zone="NMClientPermission">
<primary>NMClientPermission</primary>
</indexterm>
<para><para><link linkend="NMClientPermission">NMClientPermission</link> values indicate various permissions that NetworkManager clients can obtain to perform certain tasks on behalf of the current user.</para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_NONE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>unknown or no permission</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_NETWORK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether networking can be globally enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIFI</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether Wi-Fi can be globally enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_WWAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether WWAN (3G) can be globally enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_WIMAX</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>4</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether WiMAX can be globally enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_SLEEP_WAKE</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>5</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether the client can ask NetworkManager to sleep and wake</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_NETWORK_CONTROL</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>6</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether networking connections can be started, stopped, and changed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_WIFI_SHARE_PROTECTED</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>7</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether a password protected Wi-Fi hotspot can be created</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_WIFI_SHARE_OPEN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>8</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether an open Wi-Fi hotspot can be created</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_SETTINGS_MODIFY_SYSTEM</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>9</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether connections that are available to all users can be modified</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_SETTINGS_MODIFY_OWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>10</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether connections owned by the current user can be modified</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_SETTINGS_MODIFY_HOSTNAME</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>11</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether the persistent hostname can be changed</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_SETTINGS_MODIFY_GLOBAL_DNS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>12</literal></para><para></para></entry>
<entry role="enum_member_description"><para>modify persistent global DNS configuration</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_RELOAD</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>13</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls access to Reload.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_CHECKPOINT_ROLLBACK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>14</literal></para><para></para></entry>
<entry role="enum_member_description"><para>permission to create checkpoints.</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_STATISTICS</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>15</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether device statistics can be globally enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_ENABLE_DISABLE_CONNECTIVITY_CHECK</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>16</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether connectivity check can be enabled or disabled</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_WIFI_SCAN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>17</literal></para><para></para></entry>
<entry role="enum_member_description"><para>controls whether wifi scans can be performed</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
<refsect2 id="NMClientPermissionResult" role="enum">
<title>enum NMClientPermissionResult</title>
<indexterm zone="NMClientPermissionResult">
<primary>NMClientPermissionResult</primary>
</indexterm>
<para><para><link linkend="NMClientPermissionResult">NMClientPermissionResult</link> values indicate what authorizations and permissions the user requires to obtain a given <link linkend="NMClientPermission">NMClientPermission</link></para><para></para></para>
<refsect3 role="enum_members">
<title>Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="4">
<colspec colname="enum_members_name" colwidth="300px" />
<colspec colname="enum_members_value" colwidth="100px"/>
<colspec colname="enum_members_description" />
<tbody>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_RESULT_UNKNOWN</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>0</literal></para><para></para></entry>
<entry role="enum_member_description"><para>unknown or no authorization</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_RESULT_YES</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>1</literal></para><para></para></entry>
<entry role="enum_member_description"><para>the permission is available</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_RESULT_AUTH</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>2</literal></para><para></para></entry>
<entry role="enum_member_description"><para>authorization is necessary before the permission is available</para><para></para></entry>
</row>
<row role="constant">
<entry role="enum_member_name"><para>NM_CLIENT_PERMISSION_RESULT_NO</para><para></para></entry>
<entry role="enum_member_value"><para>= <literal>3</literal></para><para></para></entry>
<entry role="enum_member_description"><para>permission to perform the operation is denied by system policy</para><para></para></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect3>
</refsect2>
</refentry>