Tree - source-git/NetworkManager

<head>

Packit

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

Packit

<title>NetworkManager.conf: NetworkManager Reference Manual</title>

Packit

<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">

Packit

<link rel="home" href="index.html" title="NetworkManager Reference Manual">

Packit

<link rel="up" href="manpages.html" title="Part I. Manual Pages">

Packit

<link rel="prev" href="NetworkManager.html" title="NetworkManager">

Packit

<link rel="next" href="nmcli.html" title="nmcli">

Packit Service

<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">

Packit

<link rel="stylesheet" href="style.css" type="text/css">

Packit

</head>

Packit

<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

NetworkManager.conf

Packit

NetworkManager.conf — NetworkManager configuration file

Packit

Packit

Packit

Packit

Packit

Synopsis

Packit

/etc/NetworkManager/NetworkManager.conf,

Packit

    /etc/NetworkManager/conf.d/name.conf,

Packit

    /run/NetworkManager/conf.d/name.conf,

Packit

    /usr/lib/NetworkManager/conf.d/name.conf,

Packit

    /var/lib/NetworkManager/NetworkManager-intern.conf

Packit

Packit

Packit

Packit

Description

Packit

NetworkManager.conf is the configuration file for NetworkManager. It is used

Packit

    to set up various aspects of NetworkManager's behavior. The

Packit

    location of the main file and configuration directories may be changed

Packit

    through use of the --config, --config-dir,

Packit

    --system-config-dir, and --intern-config

Packit

    argument for NetworkManager, respectively.

Packit

Packit

If a default NetworkManager.conf is

Packit

    provided by your distribution's packages, you should not modify

Packit

    it, since your changes may get overwritten by package

Packit

    updates. Instead, you can add additional .conf

Packit

    files to the /etc/NetworkManager/conf.d directory.

Packit

    These will be read in order, with later files overriding earlier ones.

Packit

    Packages might install further configuration snippets to /usr/lib/NetworkManager/conf.d.

Packit

    This directory is parsed first, even before NetworkManager.conf.

Packit

    Scripts can also put per-boot configuration into /run/NetworkManager/conf.d.

Packit

    This directory is parsed second, also before NetworkManager.conf.

Packit

    The loading of a file /run/NetworkManager/conf.d/name.conf

Packit

    can be prevented by adding a file /etc/NetworkManager/conf.d/name.conf.

Packit

    Likewise, a file /usr/lib/NetworkManager/conf.d/name.conf

Packit

    can be shadowed by putting a file of the same name to either /etc/NetworkManager/conf.d

Packit

    or /run/NetworkManager/conf.d.

Packit

Packit

Packit

    NetworkManager can overwrite certain user configuration options via D-Bus or other internal

Packit

    operations. In this case it writes those changes to /var/lib/NetworkManager/NetworkManager-intern.conf.

Packit

    This file is not intended to be modified by the user, but it is read last and can shadow

Packit

    user configuration from NetworkManager.conf.

Packit

Packit

Packit

    Certain settings from the configuration can be reloaded at runtime either by sending SIGHUP signal or via

Packit

    D-Bus' Reload call.

Packit

Packit

Packit

Packit

File Format

Packit

Packit

      The configuration file format is so-called key file (sort of

Packit

      ini-style format).  It consists of sections (groups) of

Packit

      key-value pairs. Lines beginning with a '#' and blank lines are

Packit

      considered comments. Sections are started by a header line

Packit

      containing the section enclosed in '[' and ']', and ended

Packit

      implicitly by the start of the next section or the end of the

Packit

      file. Each key-value pair must be contained in a section.

Packit

Packit

Packit

      For keys that take a list of devices as their value, you can

Packit

      specify devices by their MAC addresses or interface names, or

Packit

      "*" to specify all devices. See the section called “Device List Format”

Packit

      below.

Packit

Packit

Packit

      Minimal system settings configuration file looks like this:

Packit

Packit

Packit

[main]

Packit

plugins=keyfile

Packit

Packit

Packit

Packit

Packit

      As an extension to the normal keyfile format, you can also

Packit

      append a value to a previously-set list-valued key by doing:

Packit

Packit

Packit

plugins+=another-plugin

Packit

plugins-=remove-me

Packit

Packit

Packit

Packit

Packit

Packit

Packit

main section

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

plugins

Packit

Packit

Packit

            Lists system settings plugin names separated by ','. These

Packit

            plugins are used to read and write system-wide

Packit

            connection profiles. When multiple plugins are specified, the

Packit

            connections are read from all listed plugins. When writing

Packit

            connections, the plugins will be asked to save the

Packit

            connection in the order listed here; if the first plugin

Packit

            cannot write out that connection type (or can't write out

Packit

            any connections) the next plugin is tried, etc. If none of

Packit

            the plugins can save the connection, an error is returned

Packit

            to the user.

Packit

Packit

Packit

            The default value and the number of available plugins is

Packit

            distro-specific. See the section called “Plugins”

Packit

            below for the available plugins.

Packit

            Note that NetworkManager's native keyfile

Packit

            plugin is always appended to the end of this list (if it doesn't

Packit

            already appear earlier in the list).

Packit

Packit

Packit

Packit

Packit

monitor-connection-files

Packit

This setting is deprecated and has no effect. Profiles

Packit

        from disk are never automatically reloaded. Use for example nmcli connection (re)load

Packit

        for that.

Packit

Packit

Packit

auth-polkit

Packit

Whether the system uses PolicyKit for authorization.

Packit

        If true, non-root requests are authorized using PolicyKit.

Packit

        Requests from root (user ID zero) are always granted without asking PolicyKit.

Packit

        If false, all requests will be allowed and PolicyKit is

Packit

        not used. If set to root-only PolicyKit is not used and

Packit

        all requests except root are denied.

Packit

        The default value is true.

Packit

Packit

Packit

Packit

dhcp

Packit

Packit

This key sets up what DHCP client

Packit

        NetworkManager will use. Allowed values are

Packit

        dhclient, dhcpcd, and

Packit

        internal. The dhclient

Packit

        and dhcpcd options require the indicated

Packit

        clients to be installed. The internal

Packit

        option uses a built-in DHCP client which is not currently as

Packit

        featureful as the external clients.

Packit

If this key is missing, it defaults to internal.

Packit

        If the chosen plugin is not available, clients are looked for

Packit

        in this order: dhclient, dhcpcd,

Packit

        internal.

Packit

Packit

Packit

Packit

no-auto-default

Packit

Packit

Specify devices for which

Packit

        NetworkManager shouldn't create default wired connection

Packit

        (Auto eth0).  By default, NetworkManager creates a temporary

Packit

        wired connection for any Ethernet device that is managed and

Packit

        doesn't have a connection configured. List a device in this

Packit

        option to inhibit creating the default connection for the

Packit

        device. May have the special value * to

Packit

        apply to all devices.

Packit

When the default wired connection is deleted or saved

Packit

        to a new persistent connection by a plugin, the device is

Packit

        added to a list in the file

Packit

        /var/lib/NetworkManager/no-auto-default.state

Packit

        to prevent creating the default connection for that device

Packit

        again.

Packit

See the section called “Device List Format” for the syntax how to

Packit

        specify a device.

Packit

Packit

Packit

          Example:

Packit

Packit

Packit

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

Packit

no-auto-default=eth0,eth1

Packit

no-auto-default=*

Packit

Packit

Packit

Packit

Packit

Packit

Packit

ignore-carrier

Packit

Packit

            This setting is deprecated for the per-device setting

Packit

            ignore-carrier which overwrites this setting

Packit

            if specified (See ignore-carrier).

Packit

            Otherwise, it is a list of matches to specify for which device

Packit

            carrier should be ignored. See the section called “Device List Format” for the

Packit

            syntax how to specify a device. Note that master types like

Packit

            bond, bridge, and team ignore carrier by default. You can however

Packit

            revert that default using the "except:" specifier (or better,

Packit

            use the per-device setting instead of the deprecated setting).

Packit

Packit

Packit

Packit

assume-ipv6ll-only

Packit

Packit

Packit

            Specify devices for which NetworkManager will try to

Packit

            generate a connection based on initial configuration when

Packit

            the device only has an IPv6 link-local address.

Packit

Packit

See the section called “Device List Format” for the syntax how to

Packit

           specify a device.

Packit

Packit

Packit

Packit

Packit

configure-and-quit

Packit

Packit

            When set to 'true', NetworkManager quits after

Packit

            performing initial network configuration but spawns small helpers

Packit

            to preserve DHCP leases and IPv6 addresses.  This is useful in

Packit

            environments where network setup is more or less static or it is

Packit

            desirable to save process time but still handle some dynamic

Packit

            configurations.  When this option is true,

Packit

            network configuration for Wi-Fi, WWAN, Bluetooth, ADSL, and PPPoE

Packit

            interfaces cannot be preserved due to their use of external

Packit

            services, and these devices will be deconfigured when NetworkManager

Packit

            quits even though other interface's configuration may be preserved.

Packit

            Also, to preserve DHCP addresses the 'dhcp' option

Packit

            must be set to 'internal'. The default value of

Packit

            the 'configure-and-quit' option is

Packit

            'false', meaning that NetworkManager will continue

Packit

            running after initial network configuration and continue responding

Packit

            to system and hardware events, D-Bus requests, and user commands.

Packit

Packit

Packit

Packit

hostname-mode

Packit

Packit

Packit

            Set the management mode of the hostname. This parameter will

Packit

            affect only the transient hostname. If a valid static hostname is set,

Packit

            NetworkManager will skip the update of the hostname despite the value of

Packit

            this option. An hostname empty or equal to 'localhost', 'localhost6',

Packit

            'localhost.localdomain' or 'localhost6.localdomain' is considered invalid.

Packit

Packit Service

default: NetworkManager will update the

Packit Service

          hostname with the one provided via DHCP or reverse DNS lookup of the

Packit Service

          IP address on the connection with the default route or on any

Packit Service

          connection with the property hostname.only-from-default set to

Packit Service

          'false'. Connections are considered in order of

Packit Service

          increasing value of the hostname.priority

Packit Service

          property. In case multiple connections have the same priority,

Packit Service

          connections activated earlier are considered first. If no hostname can

Packit Service

          be determined in such way, the hostname will be updated to the last

Packit Service

          one set outside NetworkManager or to 'localhost.localdomain'.

Packit

Packit Service

dhcp: this is similar to

Packit Service

          'default', with the difference that after trying to

Packit Service

          get the DHCP hostname, reverse DNS lookup is not done. Note that

Packit Service

          selecting this option is equivalent to setting the property

Packit Service

          'hostname.from-dns-lookup' to

Packit Service

          'false' globally for all connections in

Packit Service

          NetworkManager.conf.

Packit

Packit

none: NetworkManager will not manage the transient

Packit

          hostname and will never set it.

Packit

Packit

Packit

Packit

Packit

dns

Packit

Packit

Set the DNS processing mode.

Packit

If the key is unspecified, default is used,

Packit

        unless /etc/resolv.conf is a symlink to

Packit

        /run/systemd/resolve/stub-resolv.conf,

Packit

        /run/systemd/resolve/resolv.conf,

Packit

        /lib/systemd/resolv.conf or

Packit

        /usr/lib/systemd/resolv.conf.

Packit

        In that case, systemd-resolved is chosen automatically.

Packit

Packit

default: NetworkManager will update

Packit

        /etc/resolv.conf to reflect the nameservers

Packit

        provided by currently active connections. The rc-manager

Packit

        setting (below) controls how this is done.

Packit

dnsmasq: NetworkManager will run

Packit

        dnsmasq as a local caching nameserver, using "Conditional Forwarding"

Packit

        if you are connected to a VPN, and then update

Packit

        resolv.conf to point to the local

Packit

        nameserver. It is possible to pass custom options to the

Packit

        dnsmasq instance by adding them to files in the

Packit

        "/etc/NetworkManager/dnsmasq.d/"

Packit

        directory. Note that when multiple upstream servers are

Packit

        available, dnsmasq will initially contact them in parallel and

Packit

        then use the fastest to respond, probing again other servers

Packit

        after some time. This behavior can be modified passing the

Packit

        'all-servers' or 'strict-order' options to dnsmasq (see the

Packit

        manual page for more details).

Packit

systemd-resolved: NetworkManager will

Packit

        push the DNS configuration to systemd-resolved

Packit

unbound: NetworkManager will talk

Packit

        to unbound and dnssec-triggerd, using "Conditional Forwarding"

Packit

        with DNSSEC support. /etc/resolv.conf

Packit

        will be managed by dnssec-trigger daemon.

Packit

none: NetworkManager will not

Packit

        modify resolv.conf. This implies

Packit

        rc-manager unmanaged

Packit

Note that the plugins dnsmasq, systemd-resolved

Packit

        and unbound are caching local nameservers.

Packit

        Hence, when NetworkManager writes /run/NetworkManager/resolv.conf

Packit

        and /etc/resolv.conf (according to rc-manager

Packit

        setting below), the name server there will be localhost only.

Packit

        NetworkManager also writes a file /run/NetworkManager/no-stub-resolv.conf

Packit

        that contains the original name servers pushed to the DNS plugin.

Packit

When using dnsmasq and systemd-resolved

Packit

        per-connection added dns servers will always be queried using

Packit

        the device the connection has been activated on.

Packit

Packit

Packit

Packit

rc-manager

Packit

Packit

Set the resolv.conf

Packit

          management mode. This option is about how NetworkManager writes to

Packit

          /etc/resolv.conf, if at all.

Packit

          The default value depends on NetworkManager build

Packit

          options, and this version of NetworkManager was build with a default of

Packit

          "auto".

Packit

          Regardless of this setting, NetworkManager will

Packit

          always write its version of resolv.conf to its runtime state directory

Packit

          as /run/NetworkManager/resolv.conf.

Packit

Packit

If you configure dns=none or make /etc/resolv.conf

Packit

          immutable with chattr +i, NetworkManager will ignore this setting and

Packit

          always choose unmanaged (below).

Packit

Packit

auto: if systemd-resolved plugin is configured via

Packit

          the dns setting or if it gets detected as main DNS plugin,

Packit

          NetworkManager will update systemd-resolved without touching /etc/resolv.conf.

Packit

          Alternatively, if resolvconf or netconfig are enabled

Packit

          at compile time and the respective binary is found, NetworkManager will automatically use it.

Packit

          Note that if you install or uninstall these binaries, you need to reload the

Packit

          rc-manager setting with SIGHUP or

Packit

          systemctl reload NetworkManager. As last fallback

Packit

          it uses the symlink option (see next).

Packit

Packit

symlink: If /etc/resolv.conf is

Packit

          a regular file or does not exist, NetworkManager will write the file directly.

Packit

          If /etc/resolv.conf is instead a symlink, NetworkManager

Packit

          will leave it alone. Unless the symlink points to the internal file

Packit

          /run/NetworkManager/resolv.conf,

Packit

          in which case the symlink will be updated to emit an inotify notification.

Packit

          This allows the user to conveniently instruct NetworkManager not

Packit

          to manage /etc/resolv.conf by replacing it with

Packit

          a symlink.

Packit

Packit

file: NetworkManager will write

Packit

            /etc/resolv.conf as regular file. If it finds

Packit

            a symlink to an existing target, it will follow the symlink and

Packit

            update the target instead. In no case will an existing symlink

Packit

            be replaced by a file. Note that older versions of NetworkManager

Packit

            behaved differently and would replace dangling symlinks with a

Packit

            plain file.

Packit

Packit

resolvconf: NetworkManager will run

Packit

          resolvconf to update the DNS configuration.

Packit

netconfig: NetworkManager will run

Packit

          netconfig to update the DNS configuration.

Packit

unmanaged: don't touch

Packit

          /etc/resolv.conf.

Packit

none: deprecated alias for

Packit

          symlink.

Packit

Packit

Packit

Packit

systemd-resolved

Packit

Packit

Send the connection DNS configuration to

Packit

        systemd-resolved. Defaults to "true".

Packit

Packit

Note that this setting is complementary to the

Packit

        dns setting. You can keep this enabled while using

Packit

        dns set to another DNS plugin alongside

Packit

        systemd-resolved, or dns set to

Packit

        systemd-resolved to configure the system resolver to use

Packit

        systemd-resolved.

Packit

If systemd-resolved is enabled, the connectivity check resolves the

Packit

        hostname per-device.

Packit

Packit

Packit

Packit

debug

Packit

Packit

Comma separated list of options to aid

Packit

        debugging. This value will be combined with the environment

Packit

        variable NM_DEBUG. Currently, the following

Packit

        values are supported:

Packit

Packit

          RLIMIT_CORE: set ulimit -c unlimited

Packit

          to write out core dumps. Beware, that a core dump can contain

Packit

          sensitive information such as passwords or configuration settings.

Packit

Packit

Packit

          fatal-warnings: set g_log_set_always_fatal()

Packit

          to core dump on warning messages from glib. This is equivalent

Packit

          to the --g-fatal-warnings command line option.

Packit

Packit

Packit

Packit

Packit

autoconnect-retries-default

Packit

Packit

            The number of times a connection activation should be

Packit

            automatically tried before switching to another one. This

Packit

            value applies only to connections that can auto-connect

Packit

            and have a

Packit

            connection.autoconnect-retries property

Packit

            set to -1. If not specified, connections will be tried 4

Packit

            times. Setting this value to 1 means to try activation once,

Packit

            without retry.

Packit

Packit

Packit

Packit

slaves-order

Packit

Packit

            This key specifies in which order slave connections are

Packit

            auto-activated on boot or when the master activates

Packit

            them. Allowed values are name (order

Packit

            connection by interface name, the default), or

Packit

            index (order slaves by their kernel

Packit

            index).

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

keyfile section

Packit

This section contains keyfile-plugin-specific options, and

Packit

    is normally only used when you are not using any other

Packit

    distro-specific plugin.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

hostname

Packit

This key is deprecated and has no effect

Packit

          since the hostname is now stored in /etc/hostname

Packit

          or other system configuration files according to build options.

Packit

Packit

Packit

Packit

path

Packit

The location where keyfiles are read and stored.

Packit

            This defaults to "/etc/NetworkManager/system-connections".

Packit

Packit

Packit

Packit

unmanaged-devices

Packit

Packit

Set devices that should be ignored by

Packit

           NetworkManager.

Packit

Packit

See the section called “Device List Format” for the syntax on how to

Packit

           specify a device.

Packit

Packit

Packit

            Example:

Packit

Packit

Packit

unmanaged-devices=interface-name:em4

Packit

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

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

ifupdown section

Packit

This section contains ifupdown-specific options and thus only

Packit

    has effect when using the ifupdown plugin.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

managed

Packit

Packit

If set to true, then

Packit

          interfaces listed in

Packit

          /etc/network/interfaces are managed by

Packit

          NetworkManager.  If set to false, then

Packit

          any interface listed in

Packit

          /etc/network/interfaces will be ignored

Packit

          by NetworkManager. Remember that NetworkManager controls the

Packit

          default route, so because the interface is ignored,

Packit

          NetworkManager may assign the default route to some other

Packit

          interface.

Packit

Packit

            The default value is false.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

logging section

Packit

This section controls NetworkManager's logging.  Any

Packit

    settings here are overridden by the --log-level

Packit

    and --log-domains command-line options.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

level

Packit

The default logging verbosity level.

Packit

          One of OFF, ERR,

Packit

          WARN, INFO,

Packit

          DEBUG, TRACE.  The ERR

Packit

          level logs only critical errors.  WARN logs warnings that may

Packit

          reflect operation. INFO logs various informational messages that

Packit

          are useful for tracking state and operations.  DEBUG enables

Packit

          verbose logging for debugging purposes. TRACE enables even more

Packit

          verbose logging then DEBUG level.  Subsequent levels also log

Packit

          all messages from earlier levels; thus setting the log level

Packit

          to INFO also logs error and warning messages.

Packit

Packit

Packit

domains

Packit

Packit

The following log domains are available:

Packit

          PLATFORM, RFKILL, ETHER, WIFI, BT, MB, DHCP4, DHCP6, PPP,

Packit

          WIFI_SCAN, IP4, IP6, AUTOIP4, DNS, VPN, SHARING, SUPPLICANT,

Packit

          AGENTS, SETTINGS, SUSPEND, CORE, DEVICE, OLPC, WIMAX,

Packit

          INFINIBAND, FIREWALL, ADSL, BOND, VLAN, BRIDGE, DBUS_PROPS,

Packit

          TEAM, CONCHECK, DCB, DISPATCH, AUDIT, SYSTEMD, VPN_PLUGIN,

Packit

          PROXY.

Packit

In addition, these special domains can be used: NONE,

Packit

          ALL, DEFAULT, DHCP, IP.

Packit

You can specify per-domain log level overrides by

Packit

          adding a colon and a log level to any domain. E.g.,

Packit

          "WIFI:DEBUG,WIFI_SCAN:OFF".

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

backend

Packit

The logging backend. Supported values

Packit

          are "syslog" and "journal".

Packit

          When NetworkManager is started with "--debug"

Packit

          in addition all messages will be printed to stderr.

Packit Service

0d74ec

          If unspecified, the default is "syslog".

Packit

Packit

Packit

Packit

audit

Packit

Whether the audit records are delivered to

Packit

          auditd, the audit daemon.  If false, audit

Packit

          records will be sent only to the NetworkManager logging

Packit

          system. If set to true, they will be also

Packit

          sent to auditd.  The default value is false.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

connection section

Packit

Specify default values for connections.

Packit

Packit

Packit Service

      Such default values are only consulted if the corresponding per-connection property

Packit Service

      explicitly allows for that. That means, all these properties correspond to

Packit Service

      a property of the connection profile (for example connection.mud-url).

Packit Service

      Only if the per-profile property is set to a special value that indicates to use the

Packit Service

      default, the default value from NetworkManager.conf is consulted. It depends on the

Packit Service

      property, which is the special value that indicates fallback to the default, but it

Packit Service

      usually is something like empty, unset values or special numeric values like 0 or -1.

Packit Service

      That means the effectively used value can first always be configured for each profile,

Packit Service

      and these default values only matter if the per-profile values explicitly indicates

Packit Service

      to use the default from NetworkManager.conf.

Packit Service

Packit Service

Packit

      Example:

Packit

Packit

Packit

[connection]

Packit

ipv6.ip6-privacy=0

Packit

Packit

Packit

Packit

Packit Service

Supported Properties

Packit

Packit

      Not all properties can be overwritten, only the following

Packit

      properties are supported to have their default values configured

Packit

      (see nm-settings(5) for details).

Packit Service

Packit Service

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

802-1x.auth-timeout

Packit

Packit

Packit

Packit

cdma.mtu

Packit

Packit

Packit

Packit

connection.auth-retries

Packit

If left unspecified, the default value is 3 tries before failing the connection.

Packit

Packit

Packit

Packit

connection.autoconnect-slaves

Packit

Packit

Packit

Packit

connection.mud-url

Packit

If unspecified, MUD URL defaults to "none".

Packit

Packit

Packit

connection.lldp

Packit

Packit

Packit

Packit

connection.llmnr

Packit

If unspecified, the ultimate default values depends on the DNS plugin. With systemd-resolved the default currently is "yes" (2) and for all other plugins "no" (0).

Packit

Packit

Packit

connection.mdns

Packit

If unspecified, the ultimate default values depends on the DNS plugin. With systemd-resolved the default currently is "no" (0) and for all other plugins also "no" (0).

Packit

Packit

Packit

connection.stable-id

Packit

Packit

Packit

Packit

ethernet.cloned-mac-address

Packit

If left unspecified, it defaults to "preserve".

Packit

Packit

Packit

ethernet.generate-mac-address-mask

Packit

Packit

Packit

Packit

ethernet.mtu

Packit

If configured explicitly to 0, the MTU is not reconfigured during device activation unless it is required due to IPv6 constraints. If left unspecified, a DHCP/IPv6 SLAAC provided value is used or the MTU is not reconfigured during activation.

Packit

Packit

Packit

ethernet.wake-on-lan

Packit

Packit

Packit

Packit

gsm.mtu

Packit

Packit

Packit

Packit Service

hostname.from-dhcp

Packit Service

Packit Service

Packit Service

Packit Service

hostname.from-dns-lookup

Packit Service

Packit Service

Packit Service

Packit Service

hostname.only-from-default

Packit Service

Packit Service

Packit Service

Packit Service

hostname.priority

Packit Service

Packit Service

Packit Service

Packit

infiniband.mtu

Packit

If configured explicitly to 0, the MTU is not reconfigured during device activation unless it is required due to IPv6 constraints. If left unspecified, a DHCP/IPv6 SLAAC provided value is used or the MTU is left unspecified on activation.

Packit

Packit

Packit

ip-tunnel.mtu

Packit

If configured explicitly to 0, the MTU is not reconfigured during device activation unless it is required due to IPv6 constraints. If left unspecified, a DHCP/IPv6 SLAAC provided value is used or a default of 1500.

Packit

Packit

Packit

ipv4.dad-timeout

Packit

Packit

Packit

Packit

ipv4.dhcp-client-id

Packit

Packit

Packit

Packit

ipv4.dhcp-iaid

Packit

If left unspecified, it defaults to "ifname".

Packit

Packit

Packit

ipv4.dhcp-hostname-flags

Packit

If left unspecified, the value 3 (fqdn-encoded,fqdn-serv-update) is used.

Packit

Packit

Packit

ipv4.dhcp-timeout

Packit

If left unspecified, the default value for

Packit

           the interface type is used.

Packit

Packit

Packit

ipv4.dhcp-vendor-class-identifier

Packit

If left unspecified, the default is to not send the DHCP option to the server.

Packit

Packit

Packit

ipv4.dns-priority

Packit

If unspecified or zero, use 50 for VPN profiles

Packit

           and 100 for other profiles.

Packit

Packit

Packit

ipv4.route-metric

Packit

Packit

Packit

Packit

ipv4.route-table

Packit

If left unspecified, routes are only added to the main table. Note that this

Packit

            is different from explicitly selecting the main table 254, because of how NetworkManager

Packit

            removes extraneous routes from the tables.

Packit

Packit

Packit

Packit

ipv6.ra-timeout

Packit

If left unspecified, the default value depends on the sysctl solicitation settings.

Packit

Packit

Packit

ipv6.dhcp-duid

Packit

If left unspecified, it defaults to "lease".

Packit

Packit

Packit

ipv6.dhcp-iaid

Packit

If left unspecified, it defaults to "ifname".

Packit

Packit

Packit

ipv6.dhcp-hostname-flags

Packit

If left unspecified, the value 1 (fqdn-serv-update) is used.

Packit

Packit

Packit

ipv6.dhcp-timeout

Packit

If left unspecified, the default value for

Packit

           the interface type is used.

Packit

Packit

Packit

ipv6.dns-priority

Packit

If unspecified or zero, use 50 for VPN profiles

Packit

           and 100 for other profiles.

Packit

Packit

Packit

ipv6.ip6-privacy

Packit

If ipv6.ip6-privacy is unset, use the content of

Packit

            "/proc/sys/net/ipv6/conf/default/use_tempaddr" as last fallback.

Packit

Packit

Packit

Packit

ipv6.route-metric

Packit

Packit

Packit

Packit

ipv6.route-table

Packit

If left unspecified, routes are only added to the main table. Note that this

Packit

            is different from explicitly selecting the main table 254, because of how NetworkManager

Packit

            removes extraneous routes from the tables.

Packit

Packit

Packit

Packit

sriov.autoprobe-drivers

Packit

If left unspecified, drivers are autoprobed when the SR-IOV VF gets created.

Packit

Packit

Packit

vpn.timeout

Packit

If left unspecified, default value of 60 seconds is used.

Packit

Packit

Packit

wifi.ap-isolation

Packit

If left unspecified, AP isolation is disabled.

Packit

Packit

Packit

wifi.cloned-mac-address

Packit

If left unspecified, it defaults to "preserve".

Packit

Packit

Packit

wifi.generate-mac-address-mask

Packit

Packit

Packit

Packit

wifi.mac-address-randomization

Packit

If left unspecified, MAC address randomization is disabled.

Packit

            This setting is deprecated for wifi.cloned-mac-address.

Packit

Packit

Packit

Packit

wifi.mtu

Packit

If configured explicitly to 0, the MTU is not reconfigured during device activation unless it is required due to IPv6 constraints. If left unspecified, a DHCP/IPv6 SLAAC provided value is used or a default of 1500.

Packit

Packit

Packit

wifi.powersave

Packit

If left unspecified, the default value

Packit

          "ignore" will be used.

Packit

Packit

Packit

wifi-sec.pmf

Packit

If left unspecified, the default value

Packit

          "optional" will be used.

Packit

Packit

Packit

wifi-sec.fils

Packit

If left unspecified, the default value

Packit

          "optional" will be used.

Packit

Packit

Packit

wifi.wake-on-wlan

Packit

Packit

Packit

Packit

wireguard.mtu

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Sections

Packit

Packit

        You can configure multiple connection

Packit

        sections, by having different sections with a name that all start

Packit

        with "connection".

Packit

        Example:

Packit

Packit

Packit

[connection]

Packit

ipv6.ip6-privacy=0

Packit

connection.autoconnect-slaves=1

Packit

vpn.timeout=120

Packit

Packit

[connection-wifi-wlan0]

Packit

match-device=interface-name:wlan0

Packit

ipv4.route-metric=50

Packit

Packit

[connection-wifi-other]

Packit

match-device=type:wifi

Packit

ipv4.route-metric=55

Packit

ipv6.ip6-privacy=1

Packit

Packit

Packit

Packit

Packit

        The sections within one file are considered in order of appearance, with the

Packit

        exception that the [connection] section is always

Packit

        considered last. In the example above, this order is [connection-wifi-wlan0],

Packit

        [connection-wlan-other], and [connection].

Packit

        When checking for a default configuration value, the sections are searched until

Packit

        the requested value is found.

Packit

        In the example above, "ipv4.route-metric" for wlan0 interface is set to 50,

Packit

        and for all other Wi-Fi typed interfaces to 55. Also, Wi-Fi devices would have

Packit

        IPv6 private addresses enabled by default, but other devices would have it disabled.

Packit

        Note that also "wlan0" gets "ipv6.ip6-privacy=1", because although the section

Packit

        "[connection-wifi-wlan0]" matches the device, it does not contain that property

Packit

        and the search continues.

Packit

Packit

Packit

        When having different sections in multiple files, sections from files that are read

Packit

        later have higher priority. So within one file the priority of the sections is

Packit

        top-to-bottom. Across multiple files later definitions take precedence.

Packit

Packit

Packit

      The following properties further control how a connection section applies.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

match-device

Packit

An optional device spec that restricts

Packit

          when the section applies. See the section called “Device List Format”

Packit

          for the possible values.

Packit

Packit

Packit

Packit

stop-match

Packit

An optional boolean value which defaults to

Packit

          no. If the section matches (based on

Packit

          match-device), further sections will not be

Packit

          considered even if the property in question is not present. In

Packit

          the example above, if [connection-wifi-wlan0] would

Packit

          have stop-match set to yes,

Packit

          the device wlan0 would have ipv6.ip6-privacy

Packit

          property unspecified. That is, the search for the property would not continue

Packit

          in the connection sections [connection-wifi-other]

Packit

          or [connection].

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

device section

Packit

Contains per-device persistent configuration.

Packit

Packit

Packit

      Example:

Packit

Packit

Packit

[device]

Packit

match-device=interface-name:eth3

Packit

managed=1

Packit

Packit

Packit

Packit

Packit

Supported Properties

Packit

Packit

      The following properties can be configured per-device.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

managed

Packit

Packit

              Whether the device is managed or not. A device can be

Packit

              marked as managed via udev rules (ENV{NM_UNMANAGED}),

Packit

              or via setting plugins (keyfile.unmanaged-devices).

Packit

              This is yet another way. Note that this configuration

Packit

              can be overruled at runtime via D-Bus. Also, it has

Packit

              higher priority then udev rules.

Packit

Packit

Packit

Packit

carrier-wait-timeout

Packit

Packit

              Specify the timeout for waiting for carrier in milliseconds.

Packit

              When the device loses carrier, NetworkManager does not react

Packit

              immediately. Instead, it waits for this timeout before considering

Packit

              the link lost. Also, on startup, NetworkManager considers the

Packit

              device as busy for this time, as long as the device has no carrier.

Packit

              This delays startup-complete signal and NetworkManager-wait-online.

Packit

              Configuring this too high means to block NetworkManager-wait-online

Packit

              longer then necessary. Configuring it too low, means that NetworkManager

Packit

              will declare startup-complete, although carrier is about to come

Packit

              and auto-activation to kick in.

Packit

              The default is 5000 milliseconds.

Packit

Packit

Packit

Packit

ignore-carrier

Packit

Packit

Packit

              Specify devices for which NetworkManager will (partially)

Packit

              ignore the carrier state. Normally, for

Packit

              device types that support carrier-detect, such as Ethernet

Packit

              and InfiniBand, NetworkManager will only allow a

Packit

              connection to be activated on the device if carrier is

Packit

              present (ie, a cable is plugged in), and it will

Packit

              deactivate the device if carrier drops for more than a few

Packit

              seconds.

Packit

Packit

Packit

              A device with carrier ignored will allow activating connections on

Packit

              that device even when it does not have carrier, provided

Packit

              that the connection uses only statically-configured IP

Packit

              addresses. Additionally, it will allow any active

Packit

              connection (whether static or dynamic) to remain active on

Packit

              the device when carrier is lost.

Packit

Packit

Packit

              Note that the "carrier" property of NMDevices and device D-Bus

Packit

              interfaces will still reflect the actual device state; it's just

Packit

              that NetworkManager will not make use of that information.

Packit

Packit

Packit

              Master types like bond, bridge and team ignore carrier by default,

Packit

              while other device types react on carrier changes by default.

Packit

Packit

Packit

              This setting overwrites the deprecated main.ignore-carrier

Packit

              setting above.

Packit

Packit

Packit

Packit

Packit

wifi.scan-rand-mac-address

Packit

Packit

              Configures MAC address randomization of a Wi-Fi device during

Packit

              scanning. This defaults to yes in which case

Packit

              a random, locally-administered MAC address will be used.

Packit

              The setting wifi.scan-generate-mac-address-mask

Packit

              allows to influence the generated MAC address to use certain vendor

Packit

              OUIs.

Packit

              If disabled, the MAC address during scanning is left unchanged to

Packit

              whatever is configured.

Packit

              For the configured MAC address while the device is associated, see instead

Packit

              the per-connection setting wifi.cloned-mac-address.

Packit

Packit

Packit

Packit

wifi.backend

Packit

Packit

              Specify the Wi-Fi backend used for the device. Currently, supported

Packit

              are wpa_supplicant and iwd (experimental).

Packit

Packit

Packit

Packit

wifi.scan-generate-mac-address-mask

Packit

Packit

              Like the per-connection settings ethernet.generate-mac-address-mask

Packit

              and wifi.generate-mac-address-mask, this allows to configure the

Packit

              generated MAC addresses during scanning. See nm-settings(5)

Packit

              for details.

Packit

Packit

Packit

Packit Service

wifi.iwd.autoconnect

Packit Service

Packit Service

              If wifi.backend is iwd, setting this to

Packit Service

              false forces IWD's autoconnect mechanism to be disabled for

Packit Service

              this device and connections will only be initiated by NetworkManager whether

Packit Service

              commaned by a client or automatically.  Leaving it true (default)

Packit Service

              stops NetworkManager from automatically initiating connections and allows

Packit Service

              IWD to use its network ranking and scanning logic to decide the best networks

Packit Service

              to autoconnect to next.  Connections' autoconnect-priority,

Packit Service

              autoconnect-retries settings will be ignored.  Other settings

Packit Service

              like permissions or multi-connect may interfere

Packit Service

              with IWD connection attempts.

Packit Service

Packit Service

Packit Service

Packit

sriov-num-vfs

Packit

Packit

              Specify the number of virtual functions (VF) to enable

Packit

              for a PCI physical device that supports single-root I/O

Packit

              virtualization (SR-IOV).

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Sections

Packit

Packit

        The [device] section works the same as the [connection] section.

Packit

        That is, multiple sections that all start with the prefix "device" can be specified.

Packit

        The settings "match-device" and "stop-match" are available to match a device section

Packit

        on a device. The order of multiple sections is also top-down within the file and

Packit

        later files overwrite previous settings. See “Sections” under the section called “CONNECTION SECTION”

Packit

        for details.

Packit

Packit

Packit

Packit

Packit

Packit

connectivity section

Packit

This section controls NetworkManager's optional connectivity

Packit

    checking functionality.  This allows NetworkManager to detect

Packit

    whether or not the system can actually access the internet or

Packit

    whether it is behind a captive portal.

Packit

Connectivity checking serves two purposes. For one, it exposes

Packit

    a connectivity state on D-Bus, which other applications may use. For example,

Packit

    Gnome's portal helper uses this as signal to show a captive portal login

Packit

    page.

Packit

    The other use is that default-route of devices without global connectivity

Packit

    get a penalty of +20000 to the route-metric. This has the purpose to give a

Packit

    better default-route to devices that have global connectivity. For example,

Packit

    when being connected to WWAN and to a Wi-Fi network which is behind a captive

Packit

    portal, WWAN still gets preferred until login.

Packit

Note that your distribution might set /proc/sys/net/ipv4/conf/*/rp_filter to

Packit

    strict filtering. That works badly with per-device connectivity checking,

Packit

    which uses SO_BINDDEVICE to send requests on all devices. A strict rp_filter

Packit

    setting will reject any response and the connectivity check on all but the

Packit

    best route will fail.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

enabled

Packit

Whether connectivity check is enabled.

Packit

          Note that to enable connectivity check, a valid uri must

Packit

          also be configured. The value defaults to true, but since

Packit

          the uri is unset by default, connectivity check may be disabled.

Packit

          The main purpose of this option is to have a single flag

Packit

          to disable connectivity check. Note that this setting can

Packit

          also be set via D-Bus API at runtime. In that case, the value gets

Packit

          stored in /var/lib/NetworkManager/NetworkManager-intern.conf

Packit

          file.

Packit

Packit

Packit

Packit

uri

Packit

The URI of a web page to periodically

Packit

          request when connectivity is being checked.  This page

Packit

          should return the header "X-NetworkManager-Status" with a

Packit

          value of "online".  Alternatively, its body content should

Packit

          be set to "NetworkManager is online".  The body content

Packit

          check can be controlled by the response

Packit

          option.  If this option is blank or missing, connectivity

Packit

          checking is disabled.

Packit

Packit

Packit

Packit

interval

Packit

Specified in seconds; controls how often

Packit

          connectivity is checked when a network connection exists. If

Packit

          set to 0 connectivity checking is disabled.  If missing, the

Packit

          default is 300 seconds.

Packit

Packit

Packit

response

Packit

If set, controls what body content

Packit

          NetworkManager checks for when requesting the URI for

Packit

          connectivity checking.  Note that this only compares

Packit

          that the HTTP response starts with the specifid text,

Packit

          it does not compare the exact string. This behavior

Packit

          might change in the future, so avoid relying on it.

Packit

          If missing, the response defaults to "NetworkManager is online".

Packit

          If set to empty, the HTTP server is expected to answer with

Packit

          status code 204 or send no data.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

global-dns section

Packit

This section specifies global DNS settings that override

Packit

    connection-specific configuration.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

searches

Packit

Packit

             A list of search domains to be used during hostname lookup.

Packit

Packit

Packit

Packit

options

Packit

Packit

             A list of options to be passed to the hostname resolver.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

global-dns-domain sections

Packit

Sections with a name starting with the "global-dns-domain-"

Packit

    prefix allow to define global DNS configuration for specific

Packit

    domains.  The part of section name after "global-dns-domain-"

Packit

    specifies the domain name a section applies to.  More specific

Packit

    domains have the precedence over less specific ones and the

Packit

    default domain is represented by the wildcard "*".  A default

Packit

    domain section is mandatory.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

servers

Packit

Packit

             A list of addresses of DNS servers to be used for the given domain.

Packit

Packit

Packit

Packit

options

Packit

Packit

             A list of domain-specific DNS options. Not used at the moment.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

.config sections

Packit

This is a special section that contains options which apply

Packit

      to the configuration file that contains the option.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

enable

Packit

Packit

Packit

              Defaults to "true". If "false",

Packit

              the configuration file will be skipped during loading.

Packit

              Note that the main configuration file NetworkManager.conf

Packit

              cannot be disabled.

Packit

Packit

Packit

# always skip loading the config file

Packit

[.config]

Packit

enable=false

Packit

Packit

Packit

Packit

Packit

              You can also match against the version of NetworkManager. For example

Packit

              the following are valid configurations:

Packit

Packit

Packit

# only load on version 1.0.6

Packit

[.config]

Packit

enable=nm-version:1.0.6

Packit

Packit

# load on all versions 1.0.x, but not 1.2.x

Packit

[.config]

Packit

enable=nm-version:1.0

Packit

Packit

# only load on versions >= 1.1.6. This does not match

Packit

# with version 1.2.0 or 1.4.4. Only the last digit is considered.

Packit

[.config]

Packit

enable=nm-version-min:1.1.6

Packit

Packit

# only load on versions >= 1.2. Contrary to the previous

Packit

# example, this also matches with 1.2.0, 1.2.10, 1.4.4, etc.

Packit

[.config]

Packit

enable=nm-version-min:1.2

Packit

Packit

# Match against the maximum allowed version. The example matches

Packit

# versions 1.2.0, 1.2.2, 1.2.4. Again, only the last version digit

Packit

# is allowed to be smaller. So this would not match on 1.1.10.

Packit

[.config]

Packit

enable=nm-version-max:1.2.6

Packit

Packit

Packit

Packit

Packit

              You can also match against the value of the environment variable

Packit

              NM_CONFIG_ENABLE_TAG, like:

Packit

Packit

Packit

# always skip loading the file when running NetworkManager with

Packit

# environment variable "NM_CONFIG_ENABLE_TAG=TAG1"

Packit

[.config]

Packit

enable=env:TAG1

Packit

Packit

Packit

Packit

Packit

              More then one match can be specified. The configuration will be

Packit

              enabled if one of the predicates matches ("or"). The special prefix "except:" can

Packit

              be used to negate the match. Note that if one except-predicate

Packit

              matches, the entire configuration will be disabled.

Packit

              In other words, a except predicate always wins over other predicates.

Packit

              If the setting only consists of "except:" matches and none of the

Packit

              negative conditions are satisfied, the configuration is still enabled.

Packit

Packit

Packit

# enable the configuration either when the environment variable

Packit

# is present or the version is at least 1.2.0.

Packit

[.config]

Packit

enable=env:TAG2,nm-version-min:1.2

Packit

Packit

# enable the configuration for version >= 1.2.0, but disable

Packit

# it when the environment variable is set to "TAG3"

Packit

[.config]

Packit

enable=except:env:TAG3,nm-version-min:1.2

Packit

Packit

# enable the configuration on >= 1.3, >= 1.2.6, and >= 1.0.16.

Packit

# Useful if a certain feature is only present since those releases.

Packit

[.config]

Packit

enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Plugins

Packit

Packit

      Settings plugins for reading and writing connection profiles. The number of

Packit

      available plugins is distribution specific.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

keyfile

Packit

Packit

Packit

            The keyfile plugin is the generic

Packit

            plugin that supports all the connection types and

Packit

            capabilities that NetworkManager has. It writes files out

Packit

            in an .ini-style format in

Packit

            /etc/NetworkManager/system-connections.

Packit

            See nm-settings-keyfile(5)

Packit

            for details about the file format.

Packit

Packit

Packit

            The stored connection file may contain passwords, secrets and

Packit

            private keys in plain text, so it will be made readable only to

Packit

            root, and the plugin will ignore files that are readable or

Packit

            writable by any user or group other than root. See "Secret flag types"

Packit

            in nm-settings(5)

Packit

            for how to avoid storing passwords in plain text.

Packit

Packit

Packit

            This plugin is always active, and will automatically be

Packit

            used to store any connections that aren't supported by any

Packit

            other active plugin.

Packit

Packit

Packit

Packit

Packit

ifcfg-rh

Packit

Packit

            This plugin is used on the Fedora and Red Hat Enterprise

Packit

            Linux distributions to read and write configuration from

Packit

            the standard

Packit

            /etc/sysconfig/network-scripts/ifcfg-*

Packit

            files. It currently supports reading Ethernet, Wi-Fi,

Packit

            InfiniBand, VLAN, Bond, Bridge, and Team connections.

Packit

            Enabling ifcfg-rh implicitly enables

Packit

            ibft plugin, if it is available.

Packit

            This can be disabled by adding no-ibft.

Packit

            See /usr/share/doc/initscripts/sysconfig.txt

Packit

            and nm-settings-ifcfg-rh(5)

Packit

            for more information about the ifcfg file format.

Packit

Packit

Packit

Packit

ifupdown

Packit

Packit

Packit

            This plugin is used on the Debian and Ubuntu

Packit

            distributions, and reads Ethernet and Wi-Fi connections

Packit

            from /etc/network/interfaces.

Packit

Packit

Packit

            This plugin is read-only; any connections (of any type)

Packit

            added from within NetworkManager when you are using this

Packit

            plugin will be saved using the keyfile

Packit

            plugin instead.

Packit

Packit

Packit

Packit

Packit

ibft, no-ibft

Packit

Packit

            These plugins are deprecated and their selection has no effect.

Packit

            This is now handled by nm-initrd-generator.

Packit

Packit

Packit

Packit

ifcfg-suse, ifnet

Packit

Packit

            These plugins are deprecated and their selection has no effect.

Packit

            The keyfile plugin should be used

Packit

            instead.

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Appendix

Packit

Packit

Device List Format

Packit

Packit

          The configuration options main.no-auto-default, main.ignore-carrier,

Packit

          keyfile.unmanaged-devices, connection*.match-device and

Packit

          device*.match-device select devices based on a list of matchings.

Packit

          Devices can be specified using the following format:

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Matches every device.

Packit

Packit

Packit

IFNAME

Packit

Case sensitive match of interface name of the device. Globbing is not supported.

Packit

Packit

Packit

HWADDR

Packit

Match the permanent MAC address of the device. Globbing is not supported

Packit

Packit

Packit

interface-name:IFNAME, interface-name:~IFNAME

Packit

Case sensitive match of interface name of the device. Simple globbing is supported with

Packit

             * and ?. Ranges and escaping is not supported.

Packit

Packit

Packit

interface-name:=IFNAME

Packit

Case sensitive match of interface name of the device. Globbing is disabled and IFNAME

Packit

             is taken literally.

Packit

Packit

Packit

mac:HWADDR

Packit

Match the permanent MAC address of the device. Globbing is not supported

Packit

Packit

Packit

s390-subchannels:HWADDR

Packit

Match the device based on the subchannel address. Globbing is not supported

Packit

Packit

Packit

type:TYPE

Packit

Match the device type. Valid type names are as reported by "nmcli -f GENERAL.TYPE device show".

Packit

          Globbing is not supported.

Packit

Packit

Packit

driver:DRIVER

Packit

Match the device driver as reported by "nmcli -f GENERAL.DRIVER,GENERAL.DRIVER-VERSION device show".

Packit

          "DRIVER" must match the driver name exactly and does not support globbing.

Packit

          Optionally, a driver version may be specified separated by '/'. Globbing is supported for the version.

Packit

Packit

Packit

Packit

dhcp-plugin:DHCP

Packit

Match the configured DHCP plugin "main.dhcp".

Packit

Packit

Packit

Packit

except:SPEC

Packit

Packit

Negative match of a device. SPEC must be explicitly qualified with

Packit

             a prefix such as interface-name:. A negative match has higher priority then the positive

Packit

             matches above.

Packit

If there is a list consisting only of negative matches, the behavior is the same as if there

Packit

             is also match-all. That means, if none of all the negative matches is satisfied, the overall result is

Packit

             still a positive match. That means, "except:interface-name:eth0" is the same as

Packit

             "*,except:interface-name:eth0".

Packit

Packit

Packit

Packit

SPEC[,;]SPEC

Packit

Packit

Multiple specs can be concatenated with commas or semicolons. The order does not matter as

Packit

            matches are either inclusive or negative (except:), with negative matches having higher

Packit

            priority.

Packit

Packit

Backslash is supported to escape the separators ';' and ',', and to express special

Packit

            characters such as newline ('\n'), tabulator ('\t'), whitespace ('\s') and backslash ('\\'). The globbing of

Packit

            interface names cannot be escaped. Whitespace is not a separator but will be trimmed between

Packit

            two specs (unless escaped as '\s').

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

Packit

        Example:

Packit

Packit

Packit

interface-name:em4

Packit

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

Packit

interface-name:vboxnet*,except:interface-name:vboxnet2

Packit

*,except:mac:00:22:68:1c:59:b1

Packit

Packit

Packit

Packit

Packit

Packit

Packit

See Also

Packit

Packit

      NetworkManager(8),

Packit

      nmcli(1),

Packit

      nmcli-examples(7),

Packit

      nm-online(1),

Packit

      nm-settings(5),

Packit

      nm-applet(1),

Packit

      nm-connection-editor(1)

Packit

Packit

Packit

Packit

Packit Service


Generated by GTK-Doc V1.33.0

Packit

</body>

Packit