From 537bfce2bda471c92caabd388589230200891509 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Fri, 3 Jul 2026 19:53:18 +0200 Subject: New upstream version 1.58~rc1 --- man/NetworkManager.conf.xml | 66 ++++++++++++++++++++++++++++++++------------- man/nm-cloud-setup.xml | 4 +-- man/nmcli.xml | 7 ++--- man/nmtui.xml | 5 ++++ 4 files changed, 58 insertions(+), 24 deletions(-) (limited to 'man') diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml index 6c055e9d..2a14e160 100644 --- a/man/NetworkManager.conf.xml +++ b/man/NetworkManager.conf.xml @@ -83,6 +83,11 @@ note that your distribution or other packages may drop configuration snippets for NetworkManager, such that they are part of the factory default. + + The options that are indicated as boolean can be set to one of these values: + yes, true, on, 1, + no, false, off, 0. + @@ -949,6 +954,10 @@ ipv6.ip6-privacy=0 ipv4.forwarding Whether to configure IPv4 sysctl interface-specific forwarding. When enabled, the interface will act as a router to forward the IPv4 packet from one interface to another. If left unspecified, "auto" is used, so NetworkManager sets the IPv4 forwarding if any shared connection is active, or it will use the kernel default value otherwise. The "ipv4.forwarding" property is ignored when "ipv4.method" is set to "shared", because forwarding is always enabled in this case. The accepted values are: 0: disabled, 1: enabled, 2: auto, 3: ignored (leave the forwarding unchanged). + + ipv4.clat + If left unspecified, defaults to "no". + ipv4.routed-dns @@ -967,7 +976,7 @@ ipv6.ip6-privacy=0 ipv4.dhcp-ipv6-only-preferred - If left unspecified, the "IPv6-only preferred" DHCPv4 option is disabled. + If left unspecified, it defaults to "auto". ipv4.dhcp-hostname-flags @@ -1249,12 +1258,13 @@ managed=1 managed - Whether the device is managed or not. A device can be - marked as managed via udev rules (ENV{NM_UNMANAGED}), - or via setting plugins (keyfile.unmanaged-devices). - This is yet another way. Note that this configuration - can be overruled at runtime via D-Bus. Also, it has - higher priority then udev rules. + A boolean value specifying whether the device is + managed or not. A device can be marked as managed via + udev rules (ENV{NM_UNMANAGED}), or via setting plugins + (keyfile.unmanaged-devices). This is yet another + way. Note that this configuration can be overruled at + runtime via D-Bus. Also, it has higher priority than + udev rules. @@ -1323,9 +1333,27 @@ managed=1 + + check-connectivity + + + A boolean value specifying whether NetworkManager will perform a connectivity check + for this device. Defaults to yes. + + + This setting does nothing if the connectivity check has been + disabled globally using the + connectivity.enabled setting. + + + - keep-configuration + keep-configuration + + A boolean value indicating whether the existing device + configuration is kept at startup. + On startup, NetworkManager tries to not interfere with interfaces that are already configured. It does so by @@ -1422,16 +1450,16 @@ managed=1 wifi.iwd.autoconnect - If wifi.backend is iwd, setting this to - false forces IWD's autoconnect mechanism to be disabled for - this device and connections will only be initiated by NetworkManager whether - commanded by a client or automatically. Leaving it true (default) - stops NetworkManager from automatically initiating connections and allows - IWD to use its network ranking and scanning logic to decide the best networks - to autoconnect to next. Connections' autoconnect-priority, - autoconnect-retries settings will be ignored. Other settings - like permissions or multi-connect may interfere - with IWD connection attempts. + A boolean value. If wifi.backend is iwd, + setting this to false forces IWD's autoconnect mechanism to be + disabled for this device and connections will only be initiated by NetworkManager + whether commanded by a client or automatically. Leaving it true + (default) stops NetworkManager from automatically initiating connections and allows + IWD to use its network ranking and scanning logic to decide the best networks to + autoconnect to next. Connections' autoconnect-priority, + autoconnect-retries settings will be ignored. Other settings like + permissions or multi-connect may interfere with + IWD connection attempts. @@ -1490,7 +1518,7 @@ managed=1 enabled - Whether connectivity check is enabled. + A boolean indicating whether connectivity check is enabled. Note that to enable connectivity check, a valid uri must also be configured. The value defaults to true, but since the uri is unset by default, connectivity check may be disabled. diff --git a/man/nm-cloud-setup.xml b/man/nm-cloud-setup.xml index af98b592..efbfc766 100644 --- a/man/nm-cloud-setup.xml +++ b/man/nm-cloud-setup.xml @@ -143,7 +143,7 @@ script is to automatically pick up changes to the network. The dispatcher script will do nothing, unless the systemd service is - enabled. To use the dispatcher script you should therefor run + enabled. To use the dispatcher script you should therefore run systemctl enable nm-cloud-setup.service once. @@ -197,7 +197,7 @@ Enable debug logging by setting NM_CLOUD_SETUP_LOG environment variable to TRACE. In the common case where nm-cloud-setup is running as systemd service, this can be done via systemctl edit nm-cloud-setup.service and add Environment=NM_CLOUD_SETUP_LOG=TRACE to the [Service] section. Afterwards, the log can - be found in syslog via journalctl. You may also want to enable debug logging in NetworkManager as descibed + be found in syslog via journalctl. You may also want to enable debug logging in NetworkManager as described in the DEBUGGING section in NetworkManager5 manual. When sharing logs, it's best to share complete logs and not preemptively filter for NetworkManager or nm-cloud-setup logs. diff --git a/man/nmcli.xml b/man/nmcli.xml index 94f4c64c..3df25a0c 100644 --- a/man/nmcli.xml +++ b/man/nmcli.xml @@ -1734,6 +1734,7 @@ a bg + 6GHz channel @@ -1867,9 +1868,9 @@ connections with an option of restoring the network configuration to a known good state in case of an error. - If the a list of interface names is specified, the checkpoint is - taken, the checkpoint is takes only on the specified devices. Otherwise - a checkpoint is taken for all devices. + If a list of interface names is specified, the checkpoint is + taken only on the specified devices. Otherwise a checkpoint is taken for + all devices. Currently the timeout defaults to 15 seconds. This may change in a future version. diff --git a/man/nmtui.xml b/man/nmtui.xml index eac94ab0..6eb5f6af 100644 --- a/man/nmtui.xml +++ b/man/nmtui.xml @@ -84,6 +84,11 @@ Show a connection editor that supports adding, modifying, viewing and deleting connections. It provides similar functionality as nm-connection-editor. + For Wi-Fi connections, the button + displays a QR code that encodes the network credentials, so they can be + scanned to join the network from another device. When the password is + available, it is shown alongside the code; when it cannot be read + (for example, due to insufficient privileges), a warning is shown instead. -- cgit 1.3.0-6-gf8a5