From 35779c6675728fa6f0fd0a21cefb904408509c23 Mon Sep 17 00:00:00 2001 From: Sebastien Bacher Date: Mon, 5 Jul 2021 20:35:03 +0200 Subject: New upstream version 1.32.2 --- docs/api/html/NetworkManager.conf.html | 111 +++++++++++++++++++++++++++------ 1 file changed, 91 insertions(+), 20 deletions(-) (limited to 'docs/api/html/NetworkManager.conf.html') diff --git a/docs/api/html/NetworkManager.conf.html b/docs/api/html/NetworkManager.conf.html index 05250d17..96ff2802 100644 --- a/docs/api/html/NetworkManager.conf.html +++ b/docs/api/html/NetworkManager.conf.html @@ -7,7 +7,7 @@ - + @@ -17,7 +17,7 @@ Home Up Prev -Next +Next
@@ -72,6 +72,12 @@ Certain settings from the configuration can be reloaded at runtime either by sending SIGHUP signal or via D-Bus' Reload call.

+

+ NetworkManager does not require any configuration in NetworkManager.conf. Depending + on your use case, you may remove all files to restore the default configuration (factory reset). But + note that your distribution or other packages may drop configuration snippets for NetworkManager, such + that they are part of the factory default. +

File Format

@@ -91,7 +97,7 @@ below.

- Minimal system settings configuration file looks like this: + A simple configuration file looks like this: 

 [main]
@@ -326,7 +332,9 @@ no-auto-default=*
 
unbound: NetworkManager will talk
         to unbound and dnssec-triggerd, using "Conditional Forwarding"
         with DNSSEC support. /etc/resolv.conf
-        will be managed by dnssec-trigger daemon.

+        will be managed by dnssec-trigger daemon. This option is
+        deprecated. Note that dnssec-trigger ships a NetworkManager dispatcher
+        script so this DNS plugin is not necessary.

 
none: NetworkManager will not
         modify resolv.conf. This implies
         rc-manager unmanaged

@@ -456,6 +464,47 @@ no-auto-default=*
             index).
           

 
+
+
firewall-backend

+

+            The firewall backend for configuring masquerading
+            with shared mode.
+            Set to either iptables, nftables
+            or none.
+            iptables and nftables
+            require iptables and nft
+            application, respectively.
+            none means to skip firewall configuration if
+            the users wish to manage firewall themselves.
+            If unspecified, it will be auto detected.
+          

+
+
+
iwd-config-path

+
+

+            If the value is "auto" (the default), IWD is queried for its
+            current state directory when it appears on D-Bus -- the
+            directory where IWD keeps its network configuration files --
+            usually /var/lib/iwd.  NetworkManager will then attempt to
+            write copies of new or modified Wi-Fi connection profiles,
+            converted into the IWD format, into this directory thus making
+            IWD connection properties editable.  NM will overwrite existing
+            files without preserving their contents.
+          

+

+            The path can also be overriden by pointing to a specific
+            existing and writable directory.  On the other hand setting
+            this to an empty string or any other value disables the
+            profile conversion mechanism.
+          

+

+            This mechanism allows editing connection profile settings such
+            as the 802.1x configuration using NetworkManager clients.
+            Without it such changes have no effect in IWD.
+          

+
+
@@ -489,21 +538,30 @@ no-auto-default=*

unmanaged-devices

-

Set devices that should be ignored by - NetworkManager. -

-

See the section called “Device List Format” for the syntax on how to - specify a device. -

+

Set devices that should be ignored by NetworkManager. +

- Example: + A device unmanaged due to this option is strictly + unmanaged and cannot be overruled by using the API like + nmcli device set $IFNAME managed yes. + Also, a device that is unmanaged for other reasons, like + an udev rule, cannot be made managed with this option (e.g. by + using an except: specifier). + These two points make it different from the device*.managed + option which for that reason may be a better choice.

+

See the section called “Device List Format” for the syntax on how to + specify a device. +

+

+ Example: + 

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

-

+

@@ -1005,19 +1063,32 @@ managed=1

carrier-wait-timeout

-

+ +

Specify the timeout for waiting for carrier in milliseconds. + The default is 5000 milliseconds. + This setting exists because certain drivers/hardware can take + a long time to detect whether the cable is plugged in. +

+

When the device loses carrier, NetworkManager does not react immediately. Instead, it waits for this timeout before considering - the link lost. Also, on startup, NetworkManager considers the + the link lost. +

+

+ Also, on startup, NetworkManager considers the device as busy for this time, as long as the device has no carrier. This delays startup-complete signal and NetworkManager-wait-online. Configuring this too high means to block NetworkManager-wait-online - longer then necessary. Configuring it too low, means that NetworkManager - will declare startup-complete, although carrier is about to come - and auto-activation to kick in. - The default is 5000 milliseconds. -

+ longer than necessary when booting with cable unplugged. Configuring + it too low, means that NetworkManager will declare startup-complete too + soon, although carrier is about to come and auto-activation to kick in. + Note that if a profile only has static IP configuration or Layer 3 configuration + disabled, then it can already autoconnect without carrier on the device. + Once such a profile reaches full activated state, startup-complete + is considered as reached even if the device has no carrier yet. +

+

ignore-carrier

@@ -1092,7 +1163,7 @@ managed=1 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 - commaned by a client or automatically. Leaving it true (default) + 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, -- cgit 1.3.0-6-gf8a5