man: replace tabs by eight spaces in xml manual pages

This commit is contained in:
Thomas Haller
2016-01-27 12:54:18 +01:00
parent 4eda14451b
commit b51da9b030
3 changed files with 466 additions and 466 deletions

View File

@@ -84,16 +84,16 @@ Copyright 2010 - 2014 Red Hat, Inc.
<para> <para>
Minimal system settings configuration file looks like this: Minimal system settings configuration file looks like this:
<programlisting> <programlisting>
[main] [main]
plugins=keyfile plugins=keyfile
</programlisting> </programlisting>
</para> </para>
<para> <para>
As an extension to the normal keyfile format, you can also As an extension to the normal keyfile format, you can also
append a value to a previously-set list-valued key by doing: append a value to a previously-set list-valued key by doing:
<programlisting> <programlisting>
plugins+=another-plugin plugins+=another-plugin
plugins-=remove-me plugins-=remove-me
</programlisting> </programlisting>
</para> </para>
</refsect1> </refsect1>
@@ -102,201 +102,201 @@ Copyright 2010 - 2014 Red Hat, Inc.
<title><literal>main</literal> section</title> <title><literal>main</literal> section</title>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>plugins</varname></term> <term><varname>plugins</varname></term>
<listitem> <listitem>
<para> <para>
Lists system settings plugin names separated by ','. These Lists system settings plugin names separated by ','. These
plugins are used to read and write system-wide plugins are used to read and write system-wide
connections. When multiple plugins are specified, the connections. When multiple plugins are specified, the
connections are read from all listed plugins. When writing connections are read from all listed plugins. When writing
connections, the plugins will be asked to save the connections, the plugins will be asked to save the
connection in the order listed here; if the first plugin connection in the order listed here; if the first plugin
cannot write out that connection type (or can't write out cannot write out that connection type (or can't write out
any connections) the next plugin is tried, etc. If none of any connections) the next plugin is tried, etc. If none of
the plugins can save the connection, an error is returned the plugins can save the connection, an error is returned
to the user. to the user.
</para> </para>
<para> <para>
If NetworkManager defines a distro-specific If NetworkManager defines a distro-specific
network-configuration plugin for your system, then that network-configuration plugin for your system, then that
will normally be listed here. (See below for the available will normally be listed here. (See below for the available
plugins.) Note that the <literal>keyfile</literal> plugin plugins.) Note that the <literal>keyfile</literal> plugin
is always appended to the end of this list (if it doesn't is always appended to the end of this list (if it doesn't
already appear earlier in the list), so if there is no already appear earlier in the list), so if there is no
distro-specific plugin for your system then you can leave distro-specific plugin for your system then you can leave
this key unset and NetworkManager will fall back to using this key unset and NetworkManager will fall back to using
<literal>keyfile</literal>. <literal>keyfile</literal>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>monitor-connection-files</varname></term> <term><varname>monitor-connection-files</varname></term>
<listitem><para>Whether the configured settings plugin(s) <listitem><para>Whether the configured settings plugin(s)
should set up file monitors and immediately pick up changes should set up file monitors and immediately pick up changes
made to connection files while NetworkManager is running. This made to connection files while NetworkManager is running. This
is disabled by default; NetworkManager will only read is disabled by default; NetworkManager will only read
the connection files at startup, and when explicitly requested the connection files at startup, and when explicitly requested
via the ReloadConnections D-Bus call. If this key is set to via the ReloadConnections D-Bus call. If this key is set to
'<literal>true</literal>', then NetworkManager will reload '<literal>true</literal>', then NetworkManager will reload
connection files any time they changed.</para></listitem> connection files any time they changed.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>auth-polkit</varname></term> <term><varname>auth-polkit</varname></term>
<listitem><para>Whether the system uses PolicyKit for authorization. <listitem><para>Whether the system uses PolicyKit for authorization.
If <literal>false</literal>, all requests will be allowed. If If <literal>false</literal>, all requests will be allowed. If
<literal>true</literal>, non-root requests are authorized using PolicyKit. <literal>true</literal>, non-root requests are authorized using PolicyKit.
The default value is <literal>@NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT@</literal>. The default value is <literal>@NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT@</literal>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>dhcp</varname></term> <term><varname>dhcp</varname></term>
<listitem><para>This key sets up what DHCP client <listitem><para>This key sets up what DHCP client
NetworkManager will use. Allowed values are NetworkManager will use. Allowed values are
<literal>dhclient</literal>, <literal>dhcpcd</literal>, and <literal>dhclient</literal>, <literal>dhcpcd</literal>, and
<literal>internal</literal>. The <literal>dhclient</literal> <literal>internal</literal>. The <literal>dhclient</literal>
and <literal>dhcpcd</literal> options require the indicated and <literal>dhcpcd</literal> options require the indicated
clients to be installed. The <literal>internal</literal> clients to be installed. The <literal>internal</literal>
option uses a built-in DHCP client which is not currently as option uses a built-in DHCP client which is not currently as
featureful as the external clients (and in particular, does featureful as the external clients (and in particular, does
not yet support DHCPv6).</para> not yet support DHCPv6).</para>
<para>If this key is missing, available DHCP clients are <para>If this key is missing, available DHCP clients are
looked for in this order: <literal>dhclient</literal>, looked for in this order: <literal>dhclient</literal>,
<literal>dhcpcd</literal>, <literal>dhcpcd</literal>,
<literal>internal</literal>.</para></listitem> <literal>internal</literal>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>no-auto-default</varname></term> <term><varname>no-auto-default</varname></term>
<listitem><para>Specify devices for which <listitem><para>Specify devices for which
NetworkManager shouldn't create default wired connection NetworkManager shouldn't create default wired connection
(Auto eth0). By default, NetworkManager creates a temporary (Auto eth0). By default, NetworkManager creates a temporary
wired connection for any Ethernet device that is managed and wired connection for any Ethernet device that is managed and
doesn't have a connection configured. List a device in this doesn't have a connection configured. List a device in this
option to inhibit creating the default connection for the option to inhibit creating the default connection for the
device. May have the special value <literal>*</literal> to device. May have the special value <literal>*</literal> to
apply to all devices.</para> apply to all devices.</para>
<para>When the default wired connection is deleted or saved <para>When the default wired connection is deleted or saved
to a new persistent connection by a plugin, the device is to a new persistent connection by a plugin, the device is
added to a list in the file added to a list in the file
<filename>/var/run/NetworkManager/no-auto-default.state</filename> <filename>/var/run/NetworkManager/no-auto-default.state</filename>
to prevent creating the default connection for that device to prevent creating the default connection for that device
again.</para> again.</para>
<para>See <xref linkend="device-spec"/> for the syntax how to <para>See <xref linkend="device-spec"/> for the syntax how to
specify a device. specify a device.
</para> </para>
<para> <para>
Example: Example:
<programlisting> <programlisting>
no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee
no-auto-default=eth0,eth1 no-auto-default=eth0,eth1
no-auto-default=* no-auto-default=*
</programlisting> </programlisting>
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>ignore-carrier</varname></term> <term><varname>ignore-carrier</varname></term>
<listitem> <listitem>
<para> <para>
Specify devices for which NetworkManager will (partially) Specify devices for which NetworkManager will (partially)
ignore the carrier state. Normally, for ignore the carrier state. Normally, for
device types that support carrier-detect, such as Ethernet device types that support carrier-detect, such as Ethernet
and InfiniBand, NetworkManager will only allow a and InfiniBand, NetworkManager will only allow a
connection to be activated on the device if carrier is connection to be activated on the device if carrier is
present (ie, a cable is plugged in), and it will present (ie, a cable is plugged in), and it will
deactivate the device if carrier drops for more than a few deactivate the device if carrier drops for more than a few
seconds. seconds.
</para> </para>
<para> <para>
Listing a device here will allow activating connections on Listing a device here will allow activating connections on
that device even when it does not have carrier, provided that device even when it does not have carrier, provided
that the connection uses only statically-configured IP that the connection uses only statically-configured IP
addresses. Additionally, it will allow any active addresses. Additionally, it will allow any active
connection (whether static or dynamic) to remain active on connection (whether static or dynamic) to remain active on
the device when carrier is lost. the device when carrier is lost.
</para> </para>
<para> <para>
Note that the "carrier" property of NMDevices and device D-Bus Note that the "carrier" property of NMDevices and device D-Bus
interfaces will still reflect the actual device state; it's just interfaces will still reflect the actual device state; it's just
that NetworkManager will not make use of that information. that NetworkManager will not make use of that information.
</para> </para>
<para>See <xref linkend="device-spec"/> for the syntax how to <para>See <xref linkend="device-spec"/> for the syntax how to
specify a device. specify a device.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>assume-ipv6ll-only</varname></term> <term><varname>assume-ipv6ll-only</varname></term>
<listitem> <listitem>
<para> <para>
Specify devices for which NetworkManager will try to Specify devices for which NetworkManager will try to
generate a connection based on initial configuration when generate a connection based on initial configuration when
the device only has an IPv6 link-local address. the device only has an IPv6 link-local address.
</para> </para>
<para>See <xref linkend="device-spec"/> for the syntax how to <para>See <xref linkend="device-spec"/> for the syntax how to
specify a device. specify a device.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>configure-and-quit</varname></term> <term><varname>configure-and-quit</varname></term>
<listitem> <listitem>
<para> <para>
When set to '<literal>true</literal>', NetworkManager quits after When set to '<literal>true</literal>', NetworkManager quits after
performing initial network configuration but spawns small helpers performing initial network configuration but spawns small helpers
to preserve DHCP leases and IPv6 addresses. This is useful in to preserve DHCP leases and IPv6 addresses. This is useful in
environments where network setup is more or less static or it is environments where network setup is more or less static or it is
desirable to save process time but still handle some dynamic desirable to save process time but still handle some dynamic
configurations. When this option is <literal>true</literal>, configurations. When this option is <literal>true</literal>,
network configuration for WiFi, WWAN, Bluetooth, ADSL, and PPPoE network configuration for WiFi, WWAN, Bluetooth, ADSL, and PPPoE
interfaces cannot be preserved due to their use of external interfaces cannot be preserved due to their use of external
services, and these devices will be deconfigured when NetworkManager services, and these devices will be deconfigured when NetworkManager
quits even though other interface's configuration may be preserved. quits even though other interface's configuration may be preserved.
Also, to preserve DHCP addresses the '<literal>dhcp</literal>' option Also, to preserve DHCP addresses the '<literal>dhcp</literal>' option
must be set to '<literal>internal</literal>'. The default value of must be set to '<literal>internal</literal>'. The default value of
the '<literal>configure-and-quit</literal>' option is the '<literal>configure-and-quit</literal>' option is
'<literal>false</literal>', meaning that NetworkManager will continue '<literal>false</literal>', meaning that NetworkManager will continue
running after initial network configuration and continue responding running after initial network configuration and continue responding
to system and hardware events, D-Bus requests, and user commands. to system and hardware events, D-Bus requests, and user commands.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>dns</varname></term> <term><varname>dns</varname></term>
<listitem><para>Set the DNS (<filename>resolv.conf</filename>) processing mode.</para> <listitem><para>Set the DNS (<filename>resolv.conf</filename>) processing mode.</para>
<para><literal>default</literal>: The default if the key is <para><literal>default</literal>: The default if the key is
not specified. NetworkManager will update not specified. NetworkManager will update
<filename>resolv.conf</filename> to reflect the nameservers <filename>resolv.conf</filename> to reflect the nameservers
provided by currently active connections.</para> provided by currently active connections.</para>
<para><literal>dnsmasq</literal>: NetworkManager will run <para><literal>dnsmasq</literal>: NetworkManager will run
dnsmasq as a local caching nameserver, using a "split DNS" dnsmasq as a local caching nameserver, using a "split DNS"
configuration if you are connected to a VPN, and then update configuration if you are connected to a VPN, and then update
<filename>resolv.conf</filename> to point to the local <filename>resolv.conf</filename> to point to the local
nameserver.</para> nameserver.</para>
<para><literal>unbound</literal>: NetworkManager will talk <para><literal>unbound</literal>: NetworkManager will talk
to unbound and dnssec-triggerd, providing a "split DNS" to unbound and dnssec-triggerd, providing a "split DNS"
configuration with DNSSEC support. The /etc/resolv.conf configuration with DNSSEC support. The /etc/resolv.conf
will be managed by dnssec-trigger daemon.</para> will be managed by dnssec-trigger daemon.</para>
<para><literal>none</literal>: NetworkManager will not <para><literal>none</literal>: NetworkManager will not
modify resolv.conf.</para> modify resolv.conf.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>rc-manager</varname></term> <term><varname>rc-manager</varname></term>
<listitem><para>Set the <filename>resolv.conf</filename> <listitem><para>Set the <filename>resolv.conf</filename>
management mode. The default value depends on how NetworkManager management mode. The default value depends on how NetworkManager
was built.</para> was built.</para>
<para><literal>none</literal>: NetworkManager will directly <para><literal>none</literal>: NetworkManager will directly
write changes to <filename>resolv.conf</filename>.</para> write changes to <filename>resolv.conf</filename>.</para>
<para><literal>resolvconf</literal>: NetworkManager will run <para><literal>resolvconf</literal>: NetworkManager will run
resolvconf to update the DNS configuration.</para> resolvconf to update the DNS configuration.</para>
<para><literal>netconfig</literal>: NetworkManager will run <para><literal>netconfig</literal>: NetworkManager will run
netconfig to update the DNS configuration.</para> netconfig to update the DNS configuration.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@@ -329,13 +329,13 @@ no-auto-default=*
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>hostname</varname></term> <term><varname>hostname</varname></term>
<listitem><para>This key is deprecated and has no effect <listitem><para>This key is deprecated and has no effect
since the hostname is now stored in /etc/hostname or other since the hostname is now stored in /etc/hostname or other
system configuration files according to build options. system configuration files according to build options.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>path</varname></term> <term><varname>path</varname></term>
<listitem> <listitem>
@@ -344,23 +344,23 @@ no-auto-default=*
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>unmanaged-devices</varname></term> <term><varname>unmanaged-devices</varname></term>
<listitem><para>Set devices that should be ignored by <listitem><para>Set devices that should be ignored by
NetworkManager. NetworkManager.
</para> </para>
<para>See <xref linkend="device-spec"/> for the syntax how to <para>See <xref linkend="device-spec"/> for the syntax how to
specify a device. specify a device.
</para> </para>
<para> <para>
Example: Example:
<programlisting> <programlisting>
unmanaged-devices=interface-name:em4 unmanaged-devices=interface-name:em4
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2 unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2
</programlisting> </programlisting>
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -372,23 +372,23 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>managed</varname></term> <term><varname>managed</varname></term>
<listitem><para>If set to <literal>true</literal>, then <listitem><para>If set to <literal>true</literal>, then
interfaces listed in interfaces listed in
<filename>/etc/network/interfaces</filename> are managed by <filename>/etc/network/interfaces</filename> are managed by
NetworkManager. If set to <literal>false</literal>, then NetworkManager. If set to <literal>false</literal>, then
any interface listed in any interface listed in
<filename>/etc/network/interfaces</filename> will be ignored <filename>/etc/network/interfaces</filename> will be ignored
by NetworkManager. Remember that NetworkManager controls the by NetworkManager. Remember that NetworkManager controls the
default route, so because the interface is ignored, default route, so because the interface is ignored,
NetworkManager may assign the default route to some other NetworkManager may assign the default route to some other
interface.</para> interface.</para>
<para> <para>
The default value is <literal>false</literal>. The default value is <literal>false</literal>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -401,35 +401,35 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>level</varname></term> <term><varname>level</varname></term>
<listitem><para>The default logging verbosity level. <listitem><para>The default logging verbosity level.
One of <literal>OFF</literal>, <literal>ERR</literal>, One of <literal>OFF</literal>, <literal>ERR</literal>,
<literal>WARN</literal>, <literal>INFO</literal>, <literal>WARN</literal>, <literal>INFO</literal>,
<literal>DEBUG</literal>, <literal>TRACE</literal>. The ERR <literal>DEBUG</literal>, <literal>TRACE</literal>. The ERR
level logs only critical errors. WARN logs warnings that may level logs only critical errors. WARN logs warnings that may
reflect operation. INFO logs various informational messages that reflect operation. INFO logs various informational messages that
are useful for tracking state and operations. DEBUG enables are useful for tracking state and operations. DEBUG enables
verbose logging for debugging purposes. TRACE enables even more verbose logging for debugging purposes. TRACE enables even more
verbose logging then DEBUG level. Subsequent levels also log verbose logging then DEBUG level. Subsequent levels also log
all messages from earlier levels; thus setting the log level all messages from earlier levels; thus setting the log level
to INFO also logs error and warning messages.</para></listitem> to INFO also logs error and warning messages.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>domains</varname></term> <term><varname>domains</varname></term>
<listitem><para>The following log domains are available: <listitem><para>The following log domains are available:
PLATFORM, RFKILL, ETHER, WIFI, BT, MB, DHCP4, DHCP6, PPP, PLATFORM, RFKILL, ETHER, WIFI, BT, MB, DHCP4, DHCP6, PPP,
WIFI_SCAN, IP4, IP6, AUTOIP4, DNS, VPN, SHARING, SUPPLICANT, WIFI_SCAN, IP4, IP6, AUTOIP4, DNS, VPN, SHARING, SUPPLICANT,
AGENTS, SETTINGS, SUSPEND, CORE, DEVICE, OLPC, WIMAX, AGENTS, SETTINGS, SUSPEND, CORE, DEVICE, OLPC, WIMAX,
INFINIBAND, FIREWALL, ADSL, BOND, VLAN, BRIDGE, DBUS_PROPS, INFINIBAND, FIREWALL, ADSL, BOND, VLAN, BRIDGE, DBUS_PROPS,
TEAM, CONCHECK, DCB, DISPATCH, AUDIT.</para> TEAM, CONCHECK, DCB, DISPATCH, AUDIT.</para>
<para>In addition, these special domains can be used: NONE, <para>In addition, these special domains can be used: NONE,
ALL, DEFAULT, DHCP, IP.</para> ALL, DEFAULT, DHCP, IP.</para>
<para>You can specify per-domain log level overrides by <para>You can specify per-domain log level overrides by
adding a colon and a log level to any domain. E.g., adding a colon and a log level to any domain. E.g.,
"<literal>WIFI:DEBUG,WIFI_SCAN:OFF</literal>".</para></listitem> "<literal>WIFI:DEBUG,WIFI_SCAN:OFF</literal>".</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<para>Domain descriptions: <para>Domain descriptions:
<simplelist type="horiz" columns="1"> <simplelist type="horiz" columns="1">
<member>PLATFORM : OS (platform) operations</member> <member>PLATFORM : OS (platform) operations</member>
@@ -479,29 +479,29 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
</simplelist> </simplelist>
</para> </para>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>backend</varname></term> <term><varname>backend</varname></term>
<listitem><para>The logging backend. Supported values <listitem><para>The logging backend. Supported values
are "<literal>debug</literal>", "<literal>syslog</literal>", are "<literal>debug</literal>", "<literal>syslog</literal>",
"<literal>journal</literal>" and "<literal>journal-syslog-style</literal>. "<literal>journal</literal>" and "<literal>journal-syslog-style</literal>.
"<literal>debug</literal>" uses syslog and logs to standard error. "<literal>debug</literal>" uses syslog and logs to standard error.
"<literal>journal-syslog-style</literal>" prints the same message to journal "<literal>journal-syslog-style</literal>" prints the same message to journal
as it would print for "<literal>syslog</literal>", containing redundant as it would print for "<literal>syslog</literal>", containing redundant
fields in the text. fields in the text.
If NetworkManager is started in debug mode (<literal>--debug</literal>) If NetworkManager is started in debug mode (<literal>--debug</literal>)
this option is ignored and "<literal>debug</literal>" is always used. this option is ignored and "<literal>debug</literal>" is always used.
Otherwise, the default is "<literal>@NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT@</literal>". Otherwise, the default is "<literal>@NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT@</literal>".
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>audit</varname></term> <term><varname>audit</varname></term>
<listitem><para>Whether the audit records are delivered to <listitem><para>Whether the audit records are delivered to
auditd, the audit daemon. If <literal>false</literal>, audit auditd, the audit daemon. If <literal>false</literal>, audit
records will be sent only to the NetworkManager logging records will be sent only to the NetworkManager logging
system. If set to <literal>true</literal>, they will be also system. If set to <literal>true</literal>, they will be also
sent to auditd. The default value is <literal>@NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT@</literal>. sent to auditd. The default value is <literal>@NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT@</literal>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -629,32 +629,32 @@ ipv6.ip6-privacy=1
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>uri</varname></term> <term><varname>uri</varname></term>
<listitem><para>The URI of a web page to periodically <listitem><para>The URI of a web page to periodically
request when connectivity is being checked. This page request when connectivity is being checked. This page
should return the header "X-NetworkManager-Status" with a should return the header "X-NetworkManager-Status" with a
value of "online". Alternatively, it's body content should value of "online". Alternatively, it's body content should
be set to "NetworkManager is online". The body content be set to "NetworkManager is online". The body content
check can be controlled by the <literal>response</literal> check can be controlled by the <literal>response</literal>
option. If this option is blank or missing, connectivity option. If this option is blank or missing, connectivity
checking is disabled. checking is disabled.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>interval</varname></term> <term><varname>interval</varname></term>
<listitem><para>Specified in seconds; controls how often <listitem><para>Specified in seconds; controls how often
connectivity is checked when a network connection exists. If connectivity is checked when a network connection exists. If
set to 0 connectivity checking is disabled. If missing, the set to 0 connectivity checking is disabled. If missing, the
default is 300 seconds.</para></listitem> default is 300 seconds.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>response</varname></term> <term><varname>response</varname></term>
<listitem><para>If set controls what body content <listitem><para>If set controls what body content
NetworkManager checks for when requesting the URI for NetworkManager checks for when requesting the URI for
connectivity checking. If missing, defaults to connectivity checking. If missing, defaults to
"NetworkManager is online" </para></listitem> "NetworkManager is online" </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -665,22 +665,22 @@ ipv6.ip6-privacy=1
connection-specific configuration.</para> connection-specific configuration.</para>
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>searches</varname></term> <term><varname>searches</varname></term>
<listitem> <listitem>
<para> <para>
A list of search domains to be used during hostname lookup. A list of search domains to be used during hostname lookup.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>options</varname></term> <term><varname>options</varname></term>
<listitem> <listitem>
<para> <para>
A list of of options to be passed to the hostname resolver. A list of of options to be passed to the hostname resolver.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -697,22 +697,22 @@ ipv6.ip6-privacy=1
</para> </para>
<para> <para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>servers</varname></term> <term><varname>servers</varname></term>
<listitem> <listitem>
<para> <para>
A list of addresses of DNS servers to be used for the given domain. A list of addresses of DNS servers to be used for the given domain.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>options</varname></term> <term><varname>options</varname></term>
<listitem> <listitem>
<para> <para>
A list of domain-specific DNS options. Not used at the moment. A list of domain-specific DNS options. Not used at the moment.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</refsect1> </refsect1>
@@ -811,86 +811,86 @@ enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>keyfile</varname></term> <term><varname>keyfile</varname></term>
<listitem> <listitem>
<para> <para>
The <literal>keyfile</literal> plugin is the generic The <literal>keyfile</literal> plugin is the generic
plugin that supports all the connection types and plugin that supports all the connection types and
capabilities that NetworkManager has. It writes files out capabilities that NetworkManager has. It writes files out
in an .ini-style format in in an .ini-style format in
/etc/NetworkManager/system-connections. /etc/NetworkManager/system-connections.
</para> </para>
<para> <para>
The stored connection file may contain passwords and The stored connection file may contain passwords and
private keys, so it will be made readable only to root, private keys, so it will be made readable only to root,
and the plugin will ignore files that are readable or and the plugin will ignore files that are readable or
writable by any user or group other than root. writable by any user or group other than root.
</para> </para>
<para> <para>
This plugin is always active, and will automatically be This plugin is always active, and will automatically be
used to store any connections that aren't supported by any used to store any connections that aren't supported by any
other active plugin. other active plugin.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>ifcfg-rh</varname></term> <term><varname>ifcfg-rh</varname></term>
<listitem> <listitem>
<para> <para>
This plugin is used on the Fedora and Red Hat Enterprise This plugin is used on the Fedora and Red Hat Enterprise
Linux distributions to read and write configuration from Linux distributions to read and write configuration from
the standard the standard
<filename>/etc/sysconfig/network-scripts/ifcfg-*</filename> <filename>/etc/sysconfig/network-scripts/ifcfg-*</filename>
files. It currently supports reading Ethernet, Wi-Fi, files. It currently supports reading Ethernet, Wi-Fi,
InfiniBand, VLAN, Bond, Bridge, and Team connections. InfiniBand, VLAN, Bond, Bridge, and Team connections.
Enabling <literal>ifcfg-rh</literal> implicitly enables Enabling <literal>ifcfg-rh</literal> implicitly enables
<literal>ibft</literal> plugin, if it is available. <literal>ibft</literal> plugin, if it is available.
This can be disabled by adding <literal>no-ibft</literal>. This can be disabled by adding <literal>no-ibft</literal>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>ifcfg-suse</varname></term> <term><varname>ifcfg-suse</varname></term>
<listitem> <listitem>
<para> <para>
This plugin is deprecated and its selection has no effect. This plugin is deprecated and its selection has no effect.
The <literal>keyfile</literal> plugin should be used The <literal>keyfile</literal> plugin should be used
instead. instead.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>ifupdown</varname></term> <term><varname>ifupdown</varname></term>
<listitem> <listitem>
<para> <para>
This plugin is used on the Debian and Ubuntu This plugin is used on the Debian and Ubuntu
distributions, and reads Ethernet and Wi-Fi connections distributions, and reads Ethernet and Wi-Fi connections
from <filename>/etc/network/interfaces</filename>. from <filename>/etc/network/interfaces</filename>.
</para> </para>
<para> <para>
This plugin is read-only; any connections (of any type) This plugin is read-only; any connections (of any type)
added from within NetworkManager when you are using this added from within NetworkManager when you are using this
plugin will be saved using the <literal>keyfile</literal> plugin will be saved using the <literal>keyfile</literal>
plugin instead. plugin instead.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>ibft</varname>, <varname>no-ibft</varname></term> <term><varname>ibft</varname>, <varname>no-ibft</varname></term>
<listitem> <listitem>
<para> <para>
This plugin allows to read iBFT configuration (iSCSI Boot Firmware Table). This plugin allows to read iBFT configuration (iSCSI Boot Firmware Table).
The configuration is read using /sbin/iscsiadm. Users are expected to The configuration is read using /sbin/iscsiadm. Users are expected to
configure iBFT connections via the firmware interfaces. configure iBFT connections via the firmware interfaces.
If ibft support is available, it is automatically enabled after If ibft support is available, it is automatically enabled after
<literal>ifcfg-rh</literal>. This can be disabled by <literal>no-ibft</literal>. <literal>ifcfg-rh</literal>. This can be disabled by <literal>no-ibft</literal>.
You can also explicitly specify <literal>ibft</literal> to load the You can also explicitly specify <literal>ibft</literal> to load the
plugin without <literal>ifcfg-rh</literal> or to change the plugin order. plugin without <literal>ifcfg-rh</literal> or to change the plugin order.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>

View File

@@ -286,79 +286,79 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><option>--version</option> | <option>-V</option></term> <term><option>--version</option> | <option>-V</option></term>
<listitem><para>Print the NetworkManager software version and exit. <listitem><para>Print the NetworkManager software version and exit.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--help</option> | <option>-h</option></term> <term><option>--help</option> | <option>-h</option></term>
<listitem><para>Print NetworkManager's available options and exit. <listitem><para>Print NetworkManager's available options and exit.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--no-daemon</option> | <option>-n</option></term> <term><option>--no-daemon</option> | <option>-n</option></term>
<listitem><para>Do not daemonize. <listitem><para>Do not daemonize.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--debug</option> | <option>-d</option></term> <term><option>--debug</option> | <option>-d</option></term>
<listitem><para>Do not daemonize, and direct log output to the <listitem><para>Do not daemonize, and direct log output to the
controlling terminal in addition to syslog. controlling terminal in addition to syslog.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--pid-file</option> | <option>-p</option></term> <term><option>--pid-file</option> | <option>-p</option></term>
<listitem><para>Specify location of a PID file. The PID file <listitem><para>Specify location of a PID file. The PID file
is used for storing PID of the running process and prevents is used for storing PID of the running process and prevents
running multiple instances. running multiple instances.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--state-file</option></term> <term><option>--state-file</option></term>
<listitem><para>Specify file for storing state of the <listitem><para>Specify file for storing state of the
NetworkManager persistently. If not specified, the default NetworkManager persistently. If not specified, the default
value of /var/lib/NetworkManager/NetworkManager.state is used. value of /var/lib/NetworkManager/NetworkManager.state is used.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--config</option></term> <term><option>--config</option></term>
<listitem><para> Specify configuration file to set up various <listitem><para> Specify configuration file to set up various
settings for NetworkManager. If not specified, the default settings for NetworkManager. If not specified, the default
value of /etc/NetworkManager/NetworkManager.conf is used with value of /etc/NetworkManager/NetworkManager.conf is used with
a fallback to the older 'nm-system-settings.conf' if located a fallback to the older 'nm-system-settings.conf' if located
in the same directory. See in the same directory. See
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information on configuration file. for more information on configuration file.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--plugins</option></term> <term><option>--plugins</option></term>
<listitem><para>List plugins used to manage system-wide <listitem><para>List plugins used to manage system-wide
connection settings. This list has preference over plugins connection settings. This list has preference over plugins
specified in the configuration file. Currently supported specified in the configuration file. Currently supported
plugins are: keyfile, <option>ifcfg-rh</option>, plugins are: keyfile, <option>ifcfg-rh</option>,
<option>ifcfg-suse</option>, <option>ifupdown</option>. <option>ifcfg-suse</option>, <option>ifupdown</option>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--log-level</option></term> <term><option>--log-level</option></term>
<listitem><para> <listitem><para>
Sets how much information NetworkManager sends to the log destination (usually Sets how much information NetworkManager sends to the log destination (usually
syslog's "daemon" facility). By default, only informational, warning, and error syslog's "daemon" facility). By default, only informational, warning, and error
messages are logged. See the section on <literal>logging</literal> in messages are logged. See the section on <literal>logging</literal> in
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information. for more information.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--log-domains</option></term> <term><option>--log-domains</option></term>
<listitem><para> <listitem><para>
A comma-separated list specifying which operations are logged to the log A comma-separated list specifying which operations are logged to the log
destination (usually syslog). By default, most domains are logging-enabled. destination (usually syslog). By default, most domains are logging-enabled.
See the section on <literal>logging</literal> in See the section on <literal>logging</literal> in
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information. for more information.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><option>--print-config</option></term> <term><option>--print-config</option></term>
@@ -380,18 +380,18 @@
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><varname>NM_UNMANAGED</varname></term> <term><varname>NM_UNMANAGED</varname></term>
<listitem><para> <listitem><para>
No default connection will be created and automatic activation No default connection will be created and automatic activation
will not be attempted when this property of a device is set to a will not be attempted when this property of a device is set to a
true value ("1" or "true"). You will still be able to attach a true value ("1" or "true"). You will still be able to attach a
connection to the device manually or observe externally added connection to the device manually or observe externally added
configuration such as addresses or routes. configuration such as addresses or routes.
</para><para> </para><para>
Create an udev rule that sets this property to prevent NetworkManager Create an udev rule that sets this property to prevent NetworkManager
from interfering with virtual Ethernet device interfaces that are from interfering with virtual Ethernet device interfaces that are
managed by virtualization tools. managed by virtualization tools.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>

View File

@@ -284,20 +284,20 @@ export LC_ALL=C
enable_disable_wifi () enable_disable_wifi ()
{ {
result=$(nmcli dev | grep "ethernet" | grep -w "connected") result=$(nmcli dev | grep "ethernet" | grep -w "connected")
if [ -n "$result" ]; then if [ -n "$result" ]; then
nmcli radio wifi off nmcli radio wifi off
else else
nmcli radio wifi on nmcli radio wifi on
fi fi
} }
if [ "$2" = "up" ]; then if [ "$2" = "up" ]; then
enable_disable_wifi enable_disable_wifi
fi fi
if [ "$2" = "down" ]; then if [ "$2" = "down" ]; then
enable_disable_wifi enable_disable_wifi
fi fi
</programlisting> </programlisting>
</example> </example>