NetworkManager

https://networkmanager.dev/docs/
Admin
NetworkManager is a system daemon that automatically manages network connections and configuration,...
Tokens:898,799
Snippets:7,559
Trust Score:9.2
Update:6 days ago
Show doc for...
Tokens:
Raw
### Compile and run C example with pkg-config

Source: https://networkmanager.dev/docs/libnm/latest/usage.html

Commands to compile the C example using pkg-config for libnm and run it, showing the expected output.

```bash
$ cc $(pkg-config --libs --cflags libnm) -o hello-nm hello-nm.c
$ ./hello-nm
NetworkManager version: 1.58.0

$ 
```

--------------------------------

### Example 9: Adding a team controller and two port connection profiles

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Adds a team controller profile named 'Team1' with configuration from 'team1-controller-json.conf', then adds two ethernet port profiles (em1 and em2) attached to Team1. The ports use default teamd configuration. Activate the setup by bringing up both ports. The profiles are marked for auto-activation by default, but manual activation may be needed if another connection is active on the device.

```bash
$ **nmcli con add type team con-name Team1 ifname Team1 config team1-controller-json.conf**
```

```bash
$ **nmcli con add type ethernet con-name Team1-port1 ifname em1 controller Team1**
```

```bash
$ **nmcli con add type ethernet con-name Team1-port2 ifname em2 controller Team1**
```

```bash
  $ **nmcli con up Team1-port1**
  $ **nmcli con up Team1-port2**
```

--------------------------------

### nm_client_get_startup

Source: https://networkmanager.dev/docs/libnm/latest/api-index-full.html

Gets the startup state.

```APIDOC
## nm_client_get_startup

### Description
Gets the startup state.

### Function
nm_client_get_startup

### Parameters
- **client** (NMClient*) - Required - The client.

### Returns
- **gboolean** - TRUE if startup.
```

--------------------------------

### Keyfile connection profile example

Source: https://networkmanager.dev/docs/api/latest/nm-settings-keyfile.html

Example of a keyfile connection profile in .ini-style format. The file is stored in /etc/NetworkManager/system-connections/ and contains sections corresponding to settings names with key-value pairs.

```ini
[connection]
id=MyDemoConnection
uuid=2f9e2d0e-7e6e-4e5f-9c8e-3b2a1d0c5f6e
type=ethernet

[ethernet]
mac-address=00:11:22:33:44:55

[ipv4]
method=auto

[ipv6]
method=auto

```

--------------------------------

### no-auto-default examples

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

Examples of specifying devices by MAC address, interface name, or wildcard to inhibit default wired connections.

```ini
no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee
no-auto-default=eth0,eth1
no-auto-default=*

```

--------------------------------

### Device List Format Example

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

Example of a device list using the format described above. It shows matching by interface name, MAC address, globbing, and negative matches.

```text
interface-name:em4
mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2
interface-name:vboxnet*,except:interface-name:vboxnet2
*,except:mac:00:22:68:1c:59:b1
```

--------------------------------

### unmanaged-devices example

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

Example of setting unmanaged devices using interface-name and MAC address specifiers. Devices listed are strictly unmanaged and cannot be overruled via the API.

```ini
unmanaged-devices=interface-name:em4
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2

```

--------------------------------

### Python example using GObject introspection

Source: https://networkmanager.dev/docs/libnm/latest/usage.html

A Python example using GObject introspection to access libnm, requiring the NM 1.0 introspection data.

```python
import gi
gi.require_version('NM', '1.0')
from gi.repository import NM

```

--------------------------------

### nm_connection_get_setting_dummy

Source: https://networkmanager.dev/docs/libnm/latest/NMConnection.html

Gets the dummy setting.

```APIDOC
## nm_connection_get_setting_dummy

### Description
Gets the dummy setting.

### Function Signature
NMSettingDummy * nm_connection_get_setting_dummy ()

### Parameters
None documented.

### Returns
NMSettingDummy * - The dummy setting.
```

--------------------------------

### nm_connection_get_setting_infiniband

Source: https://networkmanager.dev/docs/libnm/latest/NMConnection.html

Gets the InfiniBand setting.

```APIDOC
## nm_connection_get_setting_infiniband

### Description
Gets the InfiniBand setting.

### Function Signature
NMSettingInfiniband * nm_connection_get_setting_infiniband ()

### Parameters
None documented.

### Returns
NMSettingInfiniband * - The InfiniBand setting.
```

--------------------------------

### nm_connection_get_setting_ppp

Source: https://networkmanager.dev/docs/libnm/latest/NMConnection.html

Gets the PPP setting.

```APIDOC
## nm_connection_get_setting_ppp

### Description
Gets the PPP setting.

### Function Signature
NMSettingPpp * nm_connection_get_setting_ppp ()

### Parameters
None documented.

### Returns
NMSettingPpp * - The PPP setting.
```

--------------------------------

### Example [device] section configuration

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

Shows a minimal [device] section that matches interface eth3 and sets managed=1.

```ini
[device]
match-device=interface-name:eth3
managed=1

```

--------------------------------

### nm_range_get_range

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting.html

Gets the start and end of an NMRange.

```APIDOC
## nm_range_get_range

### Description
Gets the start and end of an NMRange.

### Function Signature
gboolean nm_range_get_range (const NMRange *range, gint64 *start, gint64 *end);

### Parameters
- **range** (const NMRange *) - The range.
- **start** (gint64 *) - Return location for the start.
- **end** (gint64 *) - Return location for the end.

### Returns
gboolean - TRUE if the range is valid, FALSE otherwise.
```

--------------------------------

### nm_ip_routing_rule_get_destination_port_start

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingIPConfig.html

Gets the start of the destination port range.

```APIDOC
## nm_ip_routing_rule_get_destination_port_start

### Description
Gets the start of the destination port range.

### Signature
guint16 nm_ip_routing_rule_get_destination_port_start (NMIPRoutingRule *rule);

### Parameters
- **rule** (NMIPRoutingRule *) - The rule.

### Returns
The start port.
```

--------------------------------

### Enable nm-cloud-setup for Amazon EC2 (shell commands)

Source: https://networkmanager.dev/docs/api/latest/nm-cloud-setup.html

Installs NetworkManager-cloud-setup and configures systemd to enable the service and timer for EC2. Creates a drop-in file to set NM_CLOUD_SETUP_EC2=yes, then creates symlinks to enable the service and timer, followed by a daemon-reload.

```bash
dnf install -y NetworkManager-cloud-setup

mkdir -p /etc/systemd/system/nm-cloud-setup.service.d
cat > /etc/systemd/system/nm-cloud-setup.service.d/10-enable-ec2.conf << EOF
[Service]
Environment=NM_CLOUD_SETUP_EC2=yes
EOF

# systemctl enable nm-cloud-setup.service
mkdir -p /etc/systemd/system/NetworkManager.service.wants/
ln -s /usr/lib/systemd/system/nm-cloud-setup.service /etc/systemd/system/NetworkManager.service.wants/nm-cloud-setup.service

# systemctl enable nm-cloud-setup.timer
mkdir -p /etc/systemd/system/timers.target.wants/
ln -s /etc/systemd/system/timers.target.wants/nm-cloud-setup.timer /usr/lib/systemd/system/nm-cloud-setup.timer

# systemctl daemon-reload
```

--------------------------------

### nm_ip_routing_rule_get_source_port_start

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingIPConfig.html

Gets the start of the source port range.

```APIDOC
## nm_ip_routing_rule_get_source_port_start

### Description
Gets the start of the source port range.

### Signature
guint16 nm_ip_routing_rule_get_source_port_start (NMIPRoutingRule *rule);

### Parameters
- **rule** (NMIPRoutingRule *) - The rule.

### Returns
The start port.
```

--------------------------------

### nm_ip_routing_rule_get_destination_port_start

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingIPConfig.html

Gets the start of the destination port range for the routing rule.

```APIDOC
## nm_ip_routing_rule_get_destination_port_start

### Description
Gets the start of the destination port range for the routing rule.

### Method
guint16 nm_ip_routing_rule_get_destination_port_start(const NMIPRoutingRule *self)

### Parameters
- **self** (const NMIPRoutingRule*) - the NMIPRoutingRule instance

### Returns
guint16 - the destination port start setting.

### Since
1.18
```

--------------------------------

### nm_range_get_range

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting.html

Gets the start and end values for the range. Returns TRUE if the range contains more than one element, FALSE otherwise.

```APIDOC
## nm_range_get_range

### Description
Gets the start and end values for the range.

### Function Signature
```c
gboolean
nm_range_get_range (_const NMRange *range_,
                    _guint64 *start_,
                    _guint64 *end_);
```

### Parameters
- **range** (const NMRange*) - Required - The NMRange.
- **start** (_guint64*) - Required - Location to store the start value. [out]
- **end** (_guint64*) - Required - Location to store the end value. [out]

### Returns
- **gboolean** - TRUE if the range contains more than one element, FALSE otherwise.

### Since
1.42
```

--------------------------------

### Create and connect to a Wi-Fi hotspot

Source: https://networkmanager.dev/docs/api/latest/nmcli.html

Creates a hotspot profile named 'QuickHotspot' and connects to it, printing the hotspot password for other devices to use.

```bash
nmcli -s dev wifi hotspot con-name QuickHotspot
```

--------------------------------

### Multiple connection sections example in NetworkManager.conf

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

Shows how to define multiple connection sections with different match-device rules. The [connection] section is always considered last. Properties are searched in order of appearance, so wlan0 gets ipv4.route-metric=50 and ipv6.ip6-privacy=1 from the later section.

```ini
[connection]
ipv6.ip6-privacy=0
connection.autoconnect-ports=1
vpn.timeout=120

[connection-wifi-wlan0]
match-device=interface-name:wlan0
ipv4.route-metric=50

[connection-wifi-other]
match-device=type:wifi
ipv4.route-metric=55
ipv6.ip6-privacy=1

```

--------------------------------

### Example 8: Adding a bonding controller and two port connection profiles

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Adds a bond controller connection named 'mybond0' in active-backup mode, then adds two ethernet port connections (eth1 and eth2) attached to that controller. The ports are bound to the specified interfaces.

```bash
$ **nmcli con add type bond ifname mybond0 mode active-backup**
```

```bash
$ **nmcli con add type ethernet ifname eth1 controller mybond0**
```

```bash
$ **nmcli con add type ethernet ifname eth2 controller mybond0**
```

--------------------------------

### C example: create NMClient and print version

Source: https://networkmanager.dev/docs/libnm/latest/usage.html

A minimal C program that includes NetworkManager.h, creates an NMClient, and prints the NetworkManager version. Requires glib and libnm.

```c
#include <glib.h>
#include <NetworkManager.h>

int
main (int argc, char *argv[])
{
	NMClient *client;

	client = nm_client_new (NULL, NULL);
	if (client)
		g_print ("NetworkManager version: %s\n", nm_client_get_version (client));
}

```

--------------------------------

### Example 5: Listing NetworkManager log level and domains

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Use this command to display the current NetworkManager logging level and the list of enabled logging domains. The output shows the level (e.g., INFO) and the domains (e.g., PLATFORM, RFKILL, ETHER, WIFI).

```bash
$ **nmcli general logging**
LEVEL  DOMAINS
INFO   PLATFORM,RFKILL,ETHER,WIFI,BT,MB,DHCP4,DHCP6,PPP,WIFI_SCAN,IP4,IP6,A
UTOIP4,DNS,VPN,SHARING,SUPPLICANT,AGENTS,SETTINGS,SUSPEND,CORE,DEVICE,OLPC,
WIMAX,INFINIBAND,FIREWALL,ADSL,BOND,VLAN,BRIDGE,DBUS_PROPS,TEAM,CONCHECK,DC
B,DISPATCH
```

--------------------------------

### Property: Startup

Source: https://networkmanager.dev/docs/api/latest/gdbus-org.freedesktop.NetworkManager.html

Indicates whether NM is still starting up.

```APIDOC
## Property: Startup

### Description
Indicates whether NM is still starting up; this becomes FALSE when NM has finished attempting to activate every connection that it might be able to activate at startup.

### Type
- **Type**: boolean (b)
- **Access**: readable
```

--------------------------------

### nm_range_new

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting.html

Creates a new NMRange object for the given start and end values. Setting end equal to start creates a single-element range.

```APIDOC
## nm_range_new

### Description
Creates a new NMRange object for the given range. Setting `end` equal to `start` creates a single-element range.

### Function Signature
```c
NMRange *
nm_range_new (_guint64 start_,
              _guint64 end_);
```

### Parameters
- **start** (_guint64) - Required - The first element of the range.
- **end** (_guint64) - Required - The last element of the range, must be greater than or equal to `start`.

### Returns
- **NMRange*** - The new NMRange object. Transfer full.

### Since
1.42
```

--------------------------------

### StartFind

Source: https://networkmanager.dev/docs/api/latest/gdbus-org.freedesktop.NetworkManager.Device.WifiP2P.html

Starts a find operation for Wi-Fi P2P peers. Accepts an options dictionary with a timeout key.

```APIDOC
## StartFind

### Description
Starts a find operation for Wi-Fi P2P peers. The `options` argument accepts the following keys: `timeout` (int) - Timeout value in the range of 1-600 seconds. The default is 30 seconds.

### Method
StartFind

### Parameters
#### IN a{sv} options
- **options** (a{sv}) - Required - Options of find. Accepts key `timeout` (int) with range 1-600 seconds, default 30.

### Since
1.16
```

--------------------------------

### nm_vpn_plugin_info_new_with_data

Source: https://networkmanager.dev/docs/libnm/latest/NMVpnPluginInfo.html

Constructs a plugin info instance from a GKeyFile instead of reading from a file. The keyfile must contain mandatory fields.

```APIDOC
## nm_vpn_plugin_info_new_with_data

### Description
This constructor does not read any data from file but takes instead a `keyfile` argument.

### Function Signature
```c
NMVpnPluginInfo *
nm_vpn_plugin_info_new_with_data (const char *filename,
                                  GKeyFile *keyfile,
                                  GError **error);
```

### Parameters
- **filename** (const char*) - Optional - optional filename.
- **keyfile** (GKeyFile*) - Required - inject data for the plugin info instance.
- **error** (GError**) - Required - construction may fail if the keyfile lacks mandatory fields. In this case, return the error reason.

### Returns
new plugin info instance.

### Since
1.2
```

--------------------------------

### Simple NetworkManager configuration file

Source: https://networkmanager.dev/docs/api/latest/NetworkManager.conf.html

A minimal keyfile configuration with a [main] section and the plugins key set to keyfile.

```ini
[main]
plugins=keyfile

```

--------------------------------

### nm_ip_config_get_routes()

Source: https://networkmanager.dev/docs/libnm/latest/NMIPConfig.html

Gets the routes.

```APIDOC
## nm_ip_config_get_routes()

### Description
Gets the routes.

### Function Signature
```c
GPtrArray * nm_ip_config_get_routes (_NMIPConfig *config_);
```

### Parameters
- **config** (NMIPConfig*) - a NMIPConfig

### Returns
- **GPtrArray\*** - the GPtrArray containing NMIPRoutes. This is the internal copy used by the configuration, and must not be modified. The library never modifies the returned array and thus it is safe for callers to reference and keep using it. [element-type NMIPRoute][transfer none]
```

--------------------------------

### Example 7: Activating a VPN connection profile requiring interactive password input

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Activates the VPN profile 'my-vpn-con' with the '--ask' option, enabling nmcli to prompt for the VPN password on the command line when the password-flags are set to '0x02' ('always ask'). Useful for OTP-based VPNs where the password is needed each time.

```bash
$ **nmcli --ask con up my-vpn-con**
```

--------------------------------

### nm_client_get_metered

Source: https://networkmanager.dev/docs/libnm/latest/api-index-full.html

Gets the metered state.

```APIDOC
## nm_client_get_metered

### Description
Gets the metered state.

### Function
nm_client_get_metered

### Parameters
- **client** (NMClient*) - Required - The client.

### Returns
- **NMMetered** - The metered state.
```

--------------------------------

### startup

Source: https://networkmanager.dev/docs/libnm/latest/NMClient.html

Whether the daemon is still starting up.

```APIDOC
## Property: startup

### Description
Whether the daemon is still starting up.

### Type
gboolean

### Access
Read

### Default Value
FALSE

```

--------------------------------

### Example 11: Adding an ethernet connection profile with manual IP configuration

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Adds an ethernet connection profile 'my-con-em1' with manual IPv4 and IPv6 addresses, sets IPv4 and IPv6 DNS servers, and then shows the profile. The commands use 'nmcli con add' and 'nmcli con mod'.

```bash
$ **nmcli con add con-name my-con-em1 ifname em1 type ethernet \
  ip4 192.168.100.100/24 gw4 192.168.100.1 ip4 1.2.3.4 ip6 abbe::cafe**
```

```bash
$ **nmcli con mod my-con-em1 ipv4.dns "8.8.8.8 8.8.4.4"**
```

```bash
$ **nmcli con mod my-con-em1 +ipv4.dns 1.2.3.4**
```

```bash
$ **nmcli con mod my-con-em1 ipv6.dns "2001:4860:4860::8888 2001:4860:4860::8844"**
```

```bash
$ **nmcli -p con show my-con-em1**
```

--------------------------------

### nm_setting_team_get_runner

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingTeam.html

Gets the runner type.

```APIDOC
## nm_setting_team_get_runner

### Description
Gets the runner type.

### Signature
const char * nm_setting_team_get_runner (NMSettingTeam *setting);

### Parameters
- **setting** (NMSettingTeam *) - Required - The team setting.

### Returns
The runner type.
```

--------------------------------

### nm_dns_entry_get_priority

Source: https://networkmanager.dev/docs/libnm/latest/NMClient.html

Gets the priority of the entry.

```APIDOC
## nm_dns_entry_get_priority

### Description
Gets the priority of the entry.

### Function Signature
```c
int
nm_dns_entry_get_priority (NMDnsEntry *entry);
```

### Parameters
- **entry** (NMDnsEntry*) - the NMDnsEntry

### Returns
- **int** - the priority of the entry

### Since
1.6

```

--------------------------------

### nm_vpn_plugin_info_list_load

Source: https://networkmanager.dev/docs/libnm/latest/NMVpnPluginInfo.html

Loads a list of plugins from the default directories, rejecting duplicates.

```APIDOC
## nm_vpn_plugin_info_list_load

### Description
Loads a list of plugins from the default directories, rejecting duplicates.

### Method
Function

### Signature
```c
GSList *
nm_vpn_plugin_info_list_load (_void_);
```

### Parameters
None

### Returns
- **GSList *** - list of plugins loaded from the default directories. Element-type NMVpnPluginInfo, transfer full.

### Since
1.2
```

--------------------------------

### nm_setting_802_1x_get_phase2_domain_match

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting8021x.html

Gets the 'phase2-domain-match' property.

```APIDOC
## nm_setting_802_1x_get_phase2_domain_match

### Description
Gets the "phase2-domain-match" property.

### Method
const char * nm_setting_802_1x_get_phase2_domain_match(_NMSetting8021x *setting_);

### Parameters
- **setting** (NMSetting8021x*) - Required - the NMSetting8021x

### Returns
const char* - the "phase2-domain-match" property. Since: 1.24
```

--------------------------------

### nm_client_add_and_activate_connection_async

Source: https://networkmanager.dev/docs/libnm/latest/NMClient.html

Starts an asynchronous request to add a new connection and activate it.

```APIDOC
## nm_client_add_and_activate_connection_async

### Description
Starts an asynchronous request to add a new connection and activate it.

### Method
void nm_client_add_and_activate_connection_async (NMClient *client, NMConnection *connection, NMDevice *device, const char *specific_object, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);

### Parameters
- **client** (NMClient *) - Required - The NMClient instance.
- **connection** (NMConnection *) - Required - The connection to add and activate.
- **device** (NMDevice *) - Optional - The device to activate on, or NULL.
- **specific_object** (const char *) - Optional - D-Bus path of a specific object, or NULL.
- **cancellable** (GCancellable *) - Optional - Cancellable object, or NULL.
- **callback** (GAsyncReadyCallback) - Required - Callback to invoke when the operation completes.
- **user_data** (gpointer) - Optional - User data passed to the callback.
```

--------------------------------

### nm_setting_802_1x_get_phase2_domain_suffix_match

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting8021x.html

Gets the 'phase2-domain-suffix-match' property.

```APIDOC
## nm_setting_802_1x_get_phase2_domain_suffix_match

### Description
Gets the "phase2-domain-suffix-match" property.

### Method
const char * nm_setting_802_1x_get_phase2_domain_suffix_match(_NMSetting8021x *setting_);

### Parameters
- **setting** (NMSetting8021x*) - Required - the NMSetting8021x

### Returns
const char* - the "phase2-domain-suffix-match" property. Since: 1.2
```

--------------------------------

### nm_device_get_mtu

Source: https://networkmanager.dev/docs/libnm/latest/NMDevice.html

Gets the MTU of the NMDevice.

```APIDOC
## nm_device_get_mtu

### Description
Gets the MTU of the NMDevice.

### Method
Function

### Signature
```c
guint32
nm_device_get_mtu (_NMDevice *device_);
```

### Parameters
- **device** (NMDevice*) - Required - a NMDevice

### Returns
- **guint32** - the MTU of the device in bytes.
```

--------------------------------

### Creating a secrets dictionary for Wi-Fi PSK

Source: https://networkmanager.dev/docs/libnm/latest/NMSecretAgentOld.html

Example of creating a secrets dictionary to return a Wi-Fi PSK. Uses nm_simple_connection_new, nm_setting_wireless_security_new, and nm_connection_to_dbus to build the dictionary.

```c
NMConnection *secrets;
NMSettingWirelessSecurity *s_wsec;
GVariant *secrets_dict;

secrets = nm_simple_connection_new ();
s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new ();
g_object_set (G_OBJECT (s_wsec),
              NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK",
              NULL);
nm_connection_add_setting (secrets, NM_SETTING (s_wsec));
secrets_dict = nm_connection_to_dbus (secrets, NM_CONNECTION_SERIALIZE_ALL);

(call the NMSecretAgentOldGetSecretsFunc with secrets_dict)

g_object_unref (secrets);
g_variant_unref (secrets_dict);
```

--------------------------------

### nm_setting_macsec_get_validation

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingMacsec.html

Gets the validation mode.

```APIDOC
## nm_setting_macsec_get_validation

### Description
Gets the validation mode.

### Returns
NMSettingMacsecValidation - the validation mode.
```

--------------------------------

### Connect to a Wi-Fi network and create a profile

Source: https://networkmanager.dev/docs/api/latest/nmcli.html

Creates a new connection profile named 'My cafe' and connects to the 'Cafe Hotspot 1' SSID using the password 'caffeine'. Useful for first-time connections; afterwards, use 'nmcli con up id "My cafe"' to reuse the profile.

```bash
nmcli dev wifi con "Cafe Hotspot 1" password caffeine name "My cafe"
```

--------------------------------

### nm_setting_macsec_get_port

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingMacsec.html

Gets the MACsec port.

```APIDOC
## nm_setting_macsec_get_port

### Description
Gets the MACsec port.

### Returns
int - the port number.
```

--------------------------------

### nm_setting_macsec_get_mode

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingMacsec.html

Gets the MACsec mode.

```APIDOC
## nm_setting_macsec_get_mode

### Description
Gets the MACsec mode.

### Returns
NMSettingMacsecMode - the mode.
```

--------------------------------

### nm_setting_bridge_get_vlan_protocol

Source: https://networkmanager.dev/docs/libnm/latest/NMSettingBridge.html

Gets the VLAN protocol.

```APIDOC
## nm_setting_bridge_get_vlan_protocol

### Description
Gets the VLAN protocol.

### Returns
const char* - the VLAN protocol.
```

--------------------------------

### Set IPv4 address with description and confirmation

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Navigate to ipv4.addresses, view the property description with 'desc', then set an address. The editor asks to set ipv4.method to manual; answering yes changes the method. The 'print' command shows the new address.

```text
nmcli> **goto ipv4.addresses**
nmcli ipv4.addresses> desc

=== [addresses] ===
[NM property description]
Array of IP addresses.

[nmcli specific description]
Enter a list of IPv4 addresses formatted as:
  ip[/prefix], ip[/prefix],...
Missing prefix is regarded as prefix of 32.

Example: 192.168.1.5/24, 10.0.0.11/24

nmcli ipv4.addresses> set 192.168.1.100/24
Do you also want to set 'ipv4.method' to 'manual'? [yes]: yes
nmcli ipv4.addresses>
nmcli ipv4.addresses> print
addresses: 192.168.1.100/24
nmcli ipv4.addresses> back
nmcli ipv4> b
```

--------------------------------

### nm_device_get_capabilities

Source: https://networkmanager.dev/docs/libnm/latest/NMDevice.html

Gets the device' capabilities.

```APIDOC
## nm_device_get_capabilities

### Description
Gets the device' capabilities.

### Function Signature
```c
NMDeviceCapabilities nm_device_get_capabilities (NMDevice *device);
```

### Parameters
- **device** (NMDevice*) - a NMDevice

### Returns
(NMDeviceCapabilities) - the capabilities
```

--------------------------------

### nm_setting_802_1x_get_phase1_fast_provisioning

Source: https://networkmanager.dev/docs/libnm/latest/NMSetting8021x.html

Retrieves whether 'phase 1' PEAP fast provisioning should be used.

```APIDOC
## nm_setting_802_1x_get_phase1_fast_provisioning

### Description
Retrieves whether 'phase 1' PEAP fast provisioning should be used, as specified by the 'phase1-fast-provisioning' property.

### Method
Function

### Signature
```c
const char * nm_setting_802_1x_get_phase1_fast_provisioning (_NMSetting8021x *setting_);
```

### Parameters
- **setting** (NMSetting8021x*) - The NMSetting8021x object.

### Returns
- **const char\*** - The fast provisioning setting. See wpa_supplicant documentation for details.
```

--------------------------------

### nm_remote_connection_get_version_id

Source: https://networkmanager.dev/docs/libnm/latest/NMRemoteConnection.html

Gets the version-id of the profile.

```APIDOC
## nm_remote_connection_get_version_id

### Description
Gets the version-id of the profile. This ID is incremented whenever the profile is modified.

### Function Signature
```c
guint64
nm_remote_connection_get_version_id (_NMRemoteConnection *connection_);
```

### Parameters
- **connection** (NMRemoteConnection*) - the NMRemoteConnection

### Returns
- **guint64** - the version-id of the profile. This ID is incremented whenever the profile is modified.

### Since
1.44
```

--------------------------------

### nm_vpn_plugin_info_new_from_file

Source: https://networkmanager.dev/docs/libnm/latest/NMVpnPluginInfo.html

Creates a new NMVpnPluginInfo instance from a file.

```APIDOC
## nm_vpn_plugin_info_new_from_file

### Description
Creates a new NMVpnPluginInfo instance from a file.

### Function Signature
NMVpnPluginInfo * nm_vpn_plugin_info_new_from_file ()

### Returns
NMVpnPluginInfo* - A new plugin info object.
```

--------------------------------

### Show general information and Wi-Fi properties for a device with nmcli -p -f general,wifi-properties device show

Source: https://networkmanager.dev/docs/api/latest/nmcli-examples.html

Displays detailed information about a Wi-Fi interface, including general device properties and supported Wi-Fi security features.

```bash
$ **nmcli -p -f general,wifi-properties device show wlan0**
===========================================================================
                        Device details (wlan0)
===========================================================================
GENERAL.DEVICE:           wlan0
GENERAL.TYPE:             wifi
GENERAL.VENDOR:           Intel Corporation
GENERAL.PRODUCT:          PRO/Wireless 5100 AGN [Shiloh] Network Connection
GENERAL.DRIVER:           iwlwifi
GENERAL.DRIVER-VERSION:   3.8.13-100.fc17.x86_64
GENERAL.FIRMWARE-VERSION: 8.83.5.1 build 33692
GENERAL.HWADDR:           00:1E:65:37:A1:D3
GENERAL.MTU:              1500
GENERAL.STATE:            100 (connected)
GENERAL.REASON:           0 (No reason given)
GENERAL.UDI:              /sys/devices/pci0000:00/0000:00:1c.1/net/wlan0
GENERAL.IP-IFACE:         wlan0
GENERAL.IS-SOFTWARE:      no
GENERAL.NM-MANAGED:       yes
GENERAL.AUTOCONNECT:      yes
GENERAL.FIRMWARE-MISSING: no
GENERAL.CONNECTION:       My Alfa WiFi
GENERAL.CON-UUID:         85194f4c-d496-4eec-bae0-d880b4cbcf26
GENERAL.CON-PATH:         /org/freedesktop/NetworkManager/ActiveConnection/
10
---------------------------------------------------------------------------
WIFI-PROPERTIES.WEP:      yes
WIFI-PROPERTIES.WPA:      yes
WIFI-PROPERTIES.WPA2:     yes
WIFI-PROPERTIES.TKIP:     yes
WIFI-PROPERTIES.CCMP:     yes
WIFI-PROPERTIES.AP:       no
WIFI-PROPERTIES.ADHOC:    yes
---------------------------------------------------------------------------
```

--------------------------------

### nm_device_get_driver

Source: https://networkmanager.dev/docs/libnm/latest/NMDevice.html

Gets the driver of the NMDevice.

```APIDOC
## nm_device_get_driver

### Description
Gets the driver of the NMDevice.

### Function Signature
```c
const char *nm_device_get_driver (NMDevice *device);
```

### Parameters
- **device** (NMDevice*) - a NMDevice

### Returns
(const char*) - the driver of the device. This is the internal string used by the device, and must not be modified.
```

--------------------------------

### nm_client_get_startup

Source: https://networkmanager.dev/docs/libnm/latest/NMClient.html

Tests whether the daemon is still in the process of activating connections at startup.

```APIDOC
## nm_client_get_startup

### Description
Tests whether the daemon is still in the process of activating connections at startup.

### Method
nm_client_get_startup

### Signature
```
gboolean
nm_client_get_startup (_NMClient *client_);
```

### Parameters
- **client** (NMClient*) - a NMClient

### Returns
- **gboolean** - whether the daemon is still starting up
```

--------------------------------

### nm_remote_connection_get_flags

Source: https://networkmanager.dev/docs/libnm/latest/NMRemoteConnection.html

Gets the flags of the connection.

```APIDOC
## nm_remote_connection_get_flags

### Description
Gets the flags of the connection.

### Function Signature
```c
NMSettingsConnectionFlags
nm_remote_connection_get_flags (_NMRemoteConnection *connection_);
```

### Parameters
- **connection** (NMRemoteConnection*) - the NMRemoteConnection

### Returns
- **NMSettingsConnectionFlags** - the flags of the connection of type NMSettingsConnectionFlags.

### Since
1.12
```
Tokens:
Raw