merge: branch 'lr/man'
This commit is contained in:
1
.gitignore
vendored
1
.gitignore
vendored
@@ -215,7 +215,6 @@ test-*.trs
|
||||
/m4/xsize.m4
|
||||
|
||||
/man/*.[1785]
|
||||
/man/NetworkManager.conf.xml
|
||||
/man/nm-settings.xml
|
||||
/man/nm-settings-ifcfg-rh.xml
|
||||
/man/nm-settings-keyfile.xml
|
||||
|
@@ -5,11 +5,14 @@
|
||||
]>
|
||||
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
|
||||
<bookinfo>
|
||||
<title>NetworkManager D-Bus API Reference Manual</title>
|
||||
<title>NetworkManager Reference Manual</title>
|
||||
<releaseinfo>Version &version;</releaseinfo>
|
||||
|
||||
<copyright>
|
||||
<year>2012</year>
|
||||
<year>2013</year>
|
||||
<year>2014</year>
|
||||
<year>2015</year>
|
||||
<year>2016</year>
|
||||
<holder>The NetworkManager Authors</holder>
|
||||
</copyright>
|
||||
@@ -37,6 +40,19 @@
|
||||
</legalnotice>
|
||||
</bookinfo>
|
||||
|
||||
<chapter id="manpages">
|
||||
<title>Manual Pages</title>
|
||||
<xi:include href="../../man/nmcli.xml"/>
|
||||
<xi:include href="../../man/nmtui.xml"/>
|
||||
<xi:include href="../../man/nm-online.xml"/>
|
||||
<xi:include href="../../man/NetworkManager.conf.xml"/>
|
||||
<xi:include href="../../man/nm-settings.xml"><xi:fallback /></xi:include>
|
||||
<xi:include href="../../man/nm-settings-keyfile.xml"><xi:fallback /></xi:include>
|
||||
<xi:include href="../../man/nm-settings-ifcfg-rh.xml"><xi:fallback /></xi:include>
|
||||
<xi:include href="../../man/nmcli-examples.xml"/>
|
||||
<xi:include href="../../man/NetworkManager.xml"/>
|
||||
</chapter>
|
||||
|
||||
<chapter id="spec">
|
||||
<title>D-Bus API Reference</title>
|
||||
|
||||
@@ -142,20 +158,6 @@
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
<chapter id="manpages">
|
||||
<title>UNIX Manual Pages</title>
|
||||
<xi:include href="../../man/nmcli.xml"/>
|
||||
<xi:include href="../../man/nmtui.xml"/>
|
||||
<xi:include href="../../man/nm-online.xml"/>
|
||||
<xi:include href="../../man/NetworkManager.xml"/>
|
||||
<xi:include href="../../man/NetworkManager.conf.xml"/>
|
||||
<xi:include href="../../man/nmcli-examples.xml"/>
|
||||
<xi:include href="../../man/nm-settings.xml"><xi:fallback /></xi:include>
|
||||
<xi:include href="../../man/nm-settings-keyfile.xml"><xi:fallback /></xi:include>
|
||||
<xi:include href="../../man/nm-settings-ifcfg-rh.xml"><xi:fallback /></xi:include>
|
||||
</chapter>
|
||||
|
||||
|
||||
<index>
|
||||
<title>Index</title>
|
||||
</index>
|
||||
|
@@ -10,7 +10,7 @@
|
||||
<releaseinfo>
|
||||
for libnm-glib &version;
|
||||
The latest version of this documentation can be found on-line at
|
||||
<ulink role="online-location" url="https://developer.gnome.org/libnm-glib/0.9/">https://developer.gnome.org/libnm-glib/0.9/</ulink>.
|
||||
<ulink url="https://developer.gnome.org/libnm-glib/stable/">https://developer.gnome.org/libnm-glib/stable/</ulink>.
|
||||
</releaseinfo>
|
||||
|
||||
<copyright>
|
||||
|
@@ -11,7 +11,7 @@
|
||||
<releaseinfo>
|
||||
for libnm-util &version;
|
||||
The latest version of this documentation can be found on-line at
|
||||
<ulink role="online-location" url="https://developer.gnome.org/libnm-util/0.9/">https://developer.gnome.org/libnm-util/0.9/</ulink>.
|
||||
<ulink url="https://developer.gnome.org/libnm-util/stable/">https://developer.gnome.org/libnm-util/stable/</ulink>.
|
||||
</releaseinfo>
|
||||
|
||||
<copyright>
|
||||
|
@@ -10,7 +10,7 @@
|
||||
<releaseinfo>
|
||||
for libnm &version;
|
||||
The latest version of this documentation can be found on-line at
|
||||
<ulink role="online-location" url="https://developer.gnome.org/libnm/1.0/">https://developer.gnome.org/libnm/1.0/</ulink>.
|
||||
<ulink url="https://developer.gnome.org/libnm/stable/">https://developer.gnome.org/libnm/stable/</ulink>.
|
||||
</releaseinfo>
|
||||
|
||||
<copyright>
|
||||
|
@@ -31,16 +31,6 @@ if ENABLE_GTK_DOC
|
||||
|
||||
endif
|
||||
|
||||
CLEANFILES += NetworkManager.conf.xml
|
||||
EXTRA_DIST += NetworkManager.conf.xml.in
|
||||
NetworkManager.conf.xml: $(srcdir)/NetworkManager.conf.xml.in
|
||||
$(AM_V_GEN) sed \
|
||||
-e 's|[@]NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT[@]|$(NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT)|g' \
|
||||
-e 's|[@]NM_CONFIG_KEYFILE_PATH_DEFAULT[@]|$(nmconfdir)/conf.d|g' \
|
||||
-e 's|[@]NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT[@]|$(NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT)|g' \
|
||||
-e 's|[@]NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT[@]|$(NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT)|g' \
|
||||
$< >$@
|
||||
|
||||
if BUILD_SETTING_DOCS
|
||||
|
||||
nm-settings.xml: nm-settings.xsl $(top_builddir)/libnm/nm-setting-docs.xml
|
||||
|
@@ -1,9 +1,26 @@
|
||||
<?xml version='1.0'?> <!--*-nxml-*-->
|
||||
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
|
||||
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
||||
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
||||
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
|
||||
<!ENTITY % entities SYSTEM "common.ent" >
|
||||
%entities;
|
||||
]>
|
||||
|
||||
<!--
|
||||
Copyright 2010 - 2014 Red Hat, Inc.
|
||||
NetworkManager.conf(5) manual page
|
||||
|
||||
Copyright 2010 - 2016 Red Hat, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id="NetworkManager.conf">
|
||||
@@ -17,7 +34,7 @@ Copyright 2010 - 2014 Red Hat, Inc.
|
||||
<manvolnum>5</manvolnum>
|
||||
<refmiscinfo class="source">NetworkManager</refmiscinfo>
|
||||
<refmiscinfo class="manual">Configuration</refmiscinfo>
|
||||
<refmiscinfo class="version">1.2</refmiscinfo>
|
||||
<refmiscinfo class="version">&NM_VERSION;</refmiscinfo>
|
||||
</refmeta>
|
||||
|
||||
<refnamediv>
|
||||
@@ -151,7 +168,7 @@ plugins-=remove-me
|
||||
<listitem><para>Whether the system uses PolicyKit for authorization.
|
||||
If <literal>false</literal>, all requests will be allowed. If
|
||||
<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>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
@@ -349,7 +366,7 @@ no-auto-default=*
|
||||
<term><varname>path</varname></term>
|
||||
<listitem>
|
||||
<para>The location where keyfiles are read and stored.
|
||||
This defaults to "<literal>@NM_CONFIG_KEYFILE_PATH_DEFAULT@</literal>".
|
||||
This defaults to "<filename>&sysconfdir;/NetworkManager/conf.d</filename>".
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@@ -496,7 +513,7 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
|
||||
"<literal>debug</literal>" uses syslog and logs to standard error.
|
||||
If NetworkManager is started in debug mode (<literal>--debug</literal>)
|
||||
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>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
@@ -505,7 +522,7 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
|
||||
auditd, the audit daemon. If <literal>false</literal>, audit
|
||||
records will be sent only to the NetworkManager logging
|
||||
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>
|
||||
</varlistentry>
|
||||
</variablelist>
|
@@ -7,9 +7,22 @@
|
||||
]>
|
||||
|
||||
<!--
|
||||
Copyright 2005 - 2014 Red Hat, Inc.
|
||||
NetworkManager(8) manual page
|
||||
|
||||
Copyright 2005 - 2016 Red Hat, Inc.
|
||||
Copyright 2005 - 2009 Novell, Inc.
|
||||
Copyright 2005 Robert Love
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id="NetworkManager">
|
||||
|
@@ -1,2 +1,6 @@
|
||||
<?xml version="1.0" encoding="utf-8" ?>
|
||||
<!ENTITY NM_VERSION "@NM_VERSION@">
|
||||
<!ENTITY sysconfdir "@sysconfdir@">
|
||||
<!ENTITY NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT "@NM_CONFIG_DEFAULT_AUTH_POLKIT_TEXT@">
|
||||
<!ENTITY NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT "@NM_CONFIG_LOGGING_BACKEND_DEFAULT_TEXT@">
|
||||
<!ENTITY NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT "@NM_CONFIG_DEFAULT_LOGGING_AUDIT_TEXT@">
|
||||
|
@@ -9,26 +9,18 @@
|
||||
<!--
|
||||
nm-online(1) manual page
|
||||
|
||||
This is free documentation; you can redistribute it and/or
|
||||
modify it under the terms of the GNU General Public License as
|
||||
published by the Free Software Foundation; either version 2 of
|
||||
the License, or (at your option) any later version.
|
||||
|
||||
The GNU General Public License's references to "object code"
|
||||
and "executables" are to be interpreted as the output of any
|
||||
document formatting or typesetting system, including
|
||||
intermediate and printed output.
|
||||
|
||||
This manual is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public Licence along
|
||||
with this manual; if not, write to the Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
|
||||
Copyright 2010 - 2016 Red Hat, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id='nm-online'>
|
||||
|
@@ -7,7 +7,20 @@
|
||||
]>
|
||||
|
||||
<!--
|
||||
Copyright 2013 - 2014 Red Hat, Inc.
|
||||
nmcli-examples(7) manual page
|
||||
|
||||
Copyright 2005 - 2016 Red Hat, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id="nmcli-examples">
|
||||
@@ -31,7 +44,8 @@ Copyright 2013 - 2014 Red Hat, Inc.
|
||||
|
||||
<refsynopsisdiv>
|
||||
<cmdsynopsis>
|
||||
<command>nmcli <arg choice="opt" rep="repeat">OPTIONS</arg></command>
|
||||
<command>nmcli</command>
|
||||
<arg choice="opt" rep="repeat">OPTIONS</arg>
|
||||
</cmdsynopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
@@ -47,14 +61,13 @@ Copyright 2013 - 2014 Red Hat, Inc.
|
||||
The purpose of this manual page is to provide you with various examples and
|
||||
usage scenarios of <emphasis>nmcli</emphasis>.
|
||||
</para>
|
||||
<para>Note: this page has "work-in-progress" status.</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Examples</title>
|
||||
|
||||
<example><title>Listing available Wi-Fi APs</title>
|
||||
<screen><userinput>$ nmcli device wifi list</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli device wifi list</userinput>
|
||||
* SSID MODE CHAN RATE SIGNAL BARS SECURITY
|
||||
netdatacomm_local Infra 6 54 Mbit/s 37 ▂▄__ WEP
|
||||
* F1 Infra 11 54 Mbit/s 98 ▂▄▆█ WPA1
|
||||
@@ -75,7 +88,7 @@ Copyright 2013 - 2014 Red Hat, Inc.
|
||||
</example>
|
||||
|
||||
<example><title>Showing general information and properties for a Wi-Fi interface</title>
|
||||
<screen><userinput>$ nmcli -p -f general,wifi-properties device show wlan0</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli -p -f general,wifi-properties device show wlan0</userinput>
|
||||
===========================================================================
|
||||
Device details (wlan0)
|
||||
===========================================================================
|
||||
@@ -115,7 +128,7 @@ WIFI-PROPERTIES.ADHOC: yes
|
||||
</example>
|
||||
|
||||
<example><title>Listing NetworkManager polkit permissions</title>
|
||||
<screen><userinput>$ nmcli general permissions</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli general permissions</userinput>
|
||||
PERMISSION VALUE
|
||||
org.freedesktop.NetworkManager.enable-disable-network yes
|
||||
org.freedesktop.NetworkManager.enable-disable-wifi yes
|
||||
@@ -142,7 +155,7 @@ org.freedesktop.NetworkManager.settings.modify.hostname auth</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Listing NetworkManager log level and domains</title>
|
||||
<screen><userinput>$ nmcli general logging</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli general logging</userinput>
|
||||
LEVEL DOMAINS
|
||||
INFO PLATFORM,RFKILL,ETHER,WIFI,BT,MB,DHCP4,DHCP6,PPP,WIFI_SCAN,IP4,IP6,A
|
||||
UTOIP4,DNS,VPN,SHARING,SUPPLICANT,AGENTS,SETTINGS,SUSPEND,CORE,DEVICE,OLPC,
|
||||
@@ -152,10 +165,9 @@ B,DISPATCH</screen>
|
||||
This command shows current NetworkManager logging status.
|
||||
</para>
|
||||
</example>
|
||||
|
||||
<example><title>Changing NetworkManager logging</title>
|
||||
<screen><userinput>$ nmcli g log level DEBUG domains CORE,ETHER,IP</userinput>
|
||||
<userinput>$ nmcli g log level INFO domains DEFAULT</userinput></screen>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli g log level DEBUG domains CORE,ETHER,IP</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli g log level INFO domains DEFAULT</userinput></screen>
|
||||
<para>
|
||||
The first command makes NetworkManager log in DEBUG level, and only for CORE, ETHER and
|
||||
IP domains. The second command restores the default logging state. Please refer to the
|
||||
@@ -165,9 +177,9 @@ B,DISPATCH</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Adding a bonding master and two slave connection profiles</title>
|
||||
<screen><userinput>$ nmcli con add type bond ifname mybond0 mode active-backup</userinput>
|
||||
<userinput>$ nmcli con add type ethernet ifname eth1 master mybond0</userinput>
|
||||
<userinput>$ nmcli con add type ethernet ifname eth2 master mybond0</userinput></screen>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli con add type bond ifname mybond0 mode active-backup</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet ifname eth1 master mybond0</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet ifname eth2 master mybond0</userinput></screen>
|
||||
<para>
|
||||
This example demonstrates adding a bond master connection and two slaves. The
|
||||
first command adds a master bond connection, naming the bonding interface
|
||||
@@ -179,9 +191,9 @@ B,DISPATCH</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Adding a team master and two slave connection profiles</title>
|
||||
<screen><userinput>$ nmcli con add type team con-name Team1 ifname Team1 config team1-master-json.conf</userinput>
|
||||
<userinput>$ nmcli con add type ethernet con-name Team1-slave1 ifname em1 master Team1</userinput>
|
||||
<userinput>$ nmcli con add type ethernet con-name Team1-slave2 ifname em2 master Team1</userinput></screen>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli con add type team con-name Team1 ifname Team1 config team1-master-json.conf</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet con-name Team1-slave1 ifname em1 master Team1</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet con-name Team1-slave2 ifname em2 master Team1</userinput></screen>
|
||||
<para>
|
||||
This example demonstrates adding a team master connection profile and two slaves. It is
|
||||
very similar to the bonding example. The first command adds a master team profile, naming
|
||||
@@ -194,8 +206,8 @@ B,DISPATCH</screen>
|
||||
<emphasis>em2</emphasis>. The slaves don't specify <emphasis>config</emphasis> and thus
|
||||
<emphasis>teamd</emphasis> will use its default configuration. You will activate the whole setup
|
||||
by activating both slaves:
|
||||
<screen> <userinput>$ nmcli con up Team1-slave1</userinput>
|
||||
<userinput>$ nmcli con up Team1-slave2</userinput></screen>
|
||||
<screen> <prompt>$ </prompt><userinput>nmcli con up Team1-slave1</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con up Team1-slave2</userinput></screen>
|
||||
By default, the created profiles are marked for auto-activation. But if another
|
||||
connection has been activated on the device, the new profile won't activate
|
||||
automatically and you need to activate it manually.
|
||||
@@ -203,10 +215,10 @@ B,DISPATCH</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Adding a bridge and two slave profiles</title>
|
||||
<screen><userinput>$ nmcli con add type bridge con-name TowerBridge ifname TowerBridge</userinput>
|
||||
<userinput>$ nmcli con add type ethernet con-name br-slave-1 ifname ens3 master TowerBridge</userinput>
|
||||
<userinput>$ nmcli con add type ethernet con-name br-slave-2 ifname ens4 master TowerBridge</userinput>
|
||||
<userinput>$ nmcli con modify TowerBridge bridge.stp no</userinput></screen>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli con add type bridge con-name TowerBridge ifname TowerBridge</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet con-name br-slave-1 ifname ens3 master TowerBridge</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con add type ethernet con-name br-slave-2 ifname ens4 master TowerBridge</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con modify TowerBridge bridge.stp no</userinput></screen>
|
||||
<para>
|
||||
This example demonstrates adding a bridge master connection and two slaves. The
|
||||
first command adds a master bridge connection, naming the bridge interface and
|
||||
@@ -220,12 +232,12 @@ B,DISPATCH</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Adding an ethernet connection profile with manual IP configuration</title>
|
||||
<screen><userinput>$ nmcli con add con-name my-con-em1 ifname em1 type ethernet \
|
||||
<screen><prompt>$ </prompt><userinput>nmcli con add con-name my-con-em1 ifname em1 type ethernet \
|
||||
ip4 192.168.100.100/24 gw4 192.168.100.1 ip4 1.2.3.4 ip6 abbe::cafe</userinput>
|
||||
<userinput>$ nmcli con mod my-con-em1 ipv4.dns "8.8.8.8 8.8.4.4"</userinput>
|
||||
<userinput>$ nmcli con mod my-con-em1 +ipv4.dns 1.2.3.4</userinput>
|
||||
<userinput>$ nmcli con mod my-con-em1 ipv6.dns "2001:4860:4860::8888 2001:4860:4860::8844"</userinput>
|
||||
<userinput>$ nmcli -p con show my-con-em1</userinput></screen>
|
||||
<prompt>$ </prompt><userinput>nmcli con mod my-con-em1 ipv4.dns "8.8.8.8 8.8.4.4"</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con mod my-con-em1 +ipv4.dns 1.2.3.4</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli con mod my-con-em1 ipv6.dns "2001:4860:4860::8888 2001:4860:4860::8844"</userinput>
|
||||
<prompt>$ </prompt><userinput>nmcli -p con show my-con-em1</userinput></screen>
|
||||
<para>
|
||||
The first command adds an Ethernet connection profile named <emphasis>my-con-em1</emphasis>
|
||||
that is bound to interface name <emphasis>em1</emphasis>. The profile is configured
|
||||
@@ -241,7 +253,7 @@ B,DISPATCH</screen>
|
||||
</example>
|
||||
|
||||
<example><title>Escaping colon characters in tabular mode</title>
|
||||
<screen><userinput>$ nmcli -t -f general -e yes -m tab dev show eth0</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli -t -f general -e yes -m tab dev show eth0</userinput>
|
||||
GENERAL:eth0:ethernet:Intel Corporation:82567LM Gigabit Network Connection:
|
||||
e1000e:2.1.4-k:1.8-3:00\:22\:68\:15\:29\:21:1500:100 (connected):0 (No reas
|
||||
on given):/sys/devices/pci0000\:00/0000\:00\:19.0/net/eth0:eth0:yes:yes:no:
|
||||
@@ -291,7 +303,7 @@ fi
|
||||
<para><emphasis role="bold">Example sessions of interactive connection editor</emphasis></para>
|
||||
|
||||
<example><title>Adding an ethernet connection profile in interactive editor (a)</title>
|
||||
<screen><userinput>$ nmcli connection edit type ethernet</userinput>
|
||||
<screen><prompt>$ </prompt><userinput>nmcli connection edit type ethernet</userinput>
|
||||
|
||||
===| nmcli interactive connection editor |===
|
||||
|
||||
@@ -302,7 +314,7 @@ Type 'describe [<setting>.<prop>]' for detailed property description
|
||||
|
||||
You may edit the following settings: connection, 802-3-ethernet (ethernet),
|
||||
802-1x, ipv4, ipv6, dcb
|
||||
nmcli> <userinput>print</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>print</userinput>
|
||||
===========================================================================
|
||||
Connection details
|
||||
===========================================================================
|
||||
@@ -362,13 +374,13 @@ ipv6.may-fail: yes
|
||||
ipv6.ip6-privacy: -1 (unknown)
|
||||
ipv6.dhcp-hostname: --
|
||||
---------------------------------------------------------------------------
|
||||
nmcli> <userinput>goto ethernet</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>goto ethernet</userinput>
|
||||
You may edit the following properties: port, speed, duplex, auto-negotiate,
|
||||
mac-address, cloned-mac-address, mac-address-blacklist, mtu, s390-subchann
|
||||
els, s390-nettype, s390-options
|
||||
nmcli 802-3-ethernet> set mtu 1492
|
||||
nmcli 802-3-ethernet> b
|
||||
nmcli> <userinput>goto ipv4.addresses</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>goto ipv4.addresses</userinput>
|
||||
nmcli ipv4.addresses> desc
|
||||
|
||||
=== [addresses] ===
|
||||
@@ -389,10 +401,10 @@ nmcli ipv4.addresses> print
|
||||
addresses: 192.168.1.100/24
|
||||
nmcli ipv4.addresses> back
|
||||
nmcli ipv4> b
|
||||
nmcli> <userinput>set ipv4.gateway 192.168.1.1</userinput>
|
||||
nmcli> <userinput>verify</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>set ipv4.gateway 192.168.1.1</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>verify</userinput>
|
||||
Verify connection: OK
|
||||
nmcli> <userinput>print</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>print</userinput>
|
||||
===========================================================================
|
||||
Connection details
|
||||
===========================================================================
|
||||
@@ -451,8 +463,8 @@ ipv6.may-fail: yes
|
||||
ipv6.ip6-privacy: -1 (unknown)
|
||||
ipv6.dhcp-hostname: --
|
||||
---------------------------------------------------------------------------
|
||||
nmcli> <userinput>set ipv4.dns 8.8.8.8 8.8.4.4</userinput>
|
||||
nmcli> <userinput>print</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>set ipv4.dns 8.8.8.8 8.8.4.4</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>print</userinput>
|
||||
===========================================================================
|
||||
Connection details
|
||||
===========================================================================
|
||||
@@ -512,12 +524,12 @@ ipv6.may-fail: yes
|
||||
ipv6.ip6-privacy: -1 (unknown)
|
||||
ipv6.dhcp-hostname: --
|
||||
---------------------------------------------------------------------------
|
||||
nmcli> <userinput>verify</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>verify</userinput>
|
||||
Verify connection: OK
|
||||
nmcli> <userinput>save</userinput>
|
||||
<prompt>nmcli> </prompt><userinput>save</userinput>
|
||||
Connection 'ethernet-4' (de89cdeb-a3e1-4d53-8fa0-c22546c775f4) successfully
|
||||
saved.
|
||||
nmcli> <userinput>quit</userinput></screen>
|
||||
<prompt>nmcli> </prompt><userinput>quit</userinput></screen>
|
||||
<para>
|
||||
Example session in the nmcli interactive connection editor.
|
||||
The scenario creates an Ethernet connection profile with static addressing (IPs and DNS).
|
||||
|
@@ -9,26 +9,18 @@
|
||||
<!--
|
||||
nmcli(1) manual page
|
||||
|
||||
This is free documentation; you can redistribute it and/or
|
||||
modify it under the terms of the GNU General Public License as
|
||||
published by the Free Software Foundation; either version 2 of
|
||||
the License, or (at your option) any later version.
|
||||
|
||||
The GNU General Public License's references to "object code"
|
||||
and "executables" are to be interpreted as the output of any
|
||||
document formatting or typesetting system, including
|
||||
intermediate and printed output.
|
||||
|
||||
This manual is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public Licence along
|
||||
with this manual; if not, write to the Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
|
||||
Copyright 2010 - 2016 Red Hat, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id='nmcli'>
|
||||
|
@@ -9,26 +9,18 @@
|
||||
<!--
|
||||
nmtui(1) manual page
|
||||
|
||||
This is free documentation; you can redistribute it and/or
|
||||
modify it under the terms of the GNU General Public License as
|
||||
published by the Free Software Foundation; either version 2 of
|
||||
the License, or (at your option) any later version.
|
||||
|
||||
The GNU General Public License's references to "object code"
|
||||
and "executables" are to be interpreted as the output of any
|
||||
document formatting or typesetting system, including
|
||||
intermediate and printed output.
|
||||
|
||||
This manual is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public Licence along
|
||||
with this manual; if not, write to the Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
|
||||
Copyright 2010 - 2016 Red Hat, Inc.
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||||
Texts. You may obtain a copy of the GNU Free Documentation License
|
||||
from the Free Software Foundation by visiting their Web site or by
|
||||
writing to:
|
||||
|
||||
Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
||||
-->
|
||||
|
||||
<refentry id='nmtui'>
|
||||
|
Reference in New Issue
Block a user