about summary refs log tree commit diff
path: root/man/nmcli-examples.5
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2016-04-06 00:46:19 +0200
committerMichael Biebl <biebl@debian.org>2016-04-06 00:46:19 +0200
commit2bfb3eb7d0323e69affca154395f51d8b577414d (patch)
treee3130a5146441296df6d08a0f4ac7222a854c8f8 /man/nmcli-examples.5
parentd9c99a29a0d3384c9c3d2adce430f5cb1134ab6a (diff)
Imported Upstream version 1.1.93 upstream/1.1.93
Diffstat (limited to 'man/nmcli-examples.5')
-rw-r--r--man/nmcli-examples.5693
1 files changed, 0 insertions, 693 deletions
diff --git a/man/nmcli-examples.5 b/man/nmcli-examples.5
deleted file mode 100644
index e25f8717..00000000
--- a/man/nmcli-examples.5
+++ /dev/null
@@ -1,693 +0,0 @@
-'\" t
-.\"     Title: nmcli-examples
-.\"    Author: 
-.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 19 November 2014
-.\"    Manual: Examples
-.\"    Source: NetworkManager 1.2
-.\"  Language: English
-.\"
-.TH "NMCLI\-EXAMPLES" "5" "" "NetworkManager 1\&.2" "Examples"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-nmcli-examples \- usage examples of nmcli
-.SH "SYNOPSIS"
-.HP \w'\fBnmcli\ \fR\fB[OPTIONS...]\fR\ 'u
-\fBnmcli \fR\fB[OPTIONS...]\fR
-.SH "DESCRIPTION"
-.PP
-\fInmcli\fR
-is a command\-line client for NetworkManager\&. It allows controlling NetworkManager and reporting its status\&. For more information please refer to
-\fBnmcli\fR(1)
-manual page\&.
-.PP
-The purpose of this manual page is to provide you with various examples and usage scenarios of
-\fInmcli\fR\&.
-.PP
-Note: this page has "work\-in\-progress" status\&.
-.SH "EXAMPLES"
-.PP
-\fBExample\ \&1.\ \&Listing available Wi-Fi APs\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli device wifi list
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-*  SSID               MODE    CHAN  RATE       SIGNAL  BARS  SECURITY
-   netdatacomm_local  Infra   6     54 Mbit/s  37      ▂▄__  WEP
-*  F1                 Infra   11    54 Mbit/s  98      ▂▄▆█  WPA1
-   LoremCorp          Infra   1     54 Mbit/s  62      ▂▄▆_  WPA2 802\&.1X
-   Internet           Infra   6     54 Mbit/s  29      ▂___  WPA1
-   HPB110a\&.F2672A     Ad\-Hoc  6     54 Mbit/s  22      ▂___  \-\-
-   Jozinet            Infra   1     54 Mbit/s  19      ▂___  WEP
-   VOIP               Infra   1     54 Mbit/s  20      ▂___  WEP
-   MARTINA            Infra   4     54 Mbit/s  32      ▂▄__  WPA2
-   N24PU1             Infra   7     11 Mbit/s  22      ▂___  \-\-
-   alfa               Infra   1     54 Mbit/s  67      ▂▄▆_  WPA2
-   bertnet            Infra   5     54 Mbit/s  20      ▂___  WPA1 WPA2
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This command shows how to list available Wi\-Fi networks (APs)\&. You can also use
-\fI\-\-fields\fR
-option for displaying different columns\&.
-\fBnmcli \-f all dev wifi list\fR
-will show all of them\&.
-.PP
-\fBExample\ \&2.\ \&Showing general information and properties for a Wi-Fi interface\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli \-p \-f general,wifi\-properties device show wlan0
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-===============================================================================
-                            Device details (wlan0)
-===============================================================================
-GENERAL\&.DEVICE:                         wlan0
-GENERAL\&.TYPE:                           wifi
-GENERAL\&.VENDOR:                         Intel Corporation
-GENERAL\&.PRODUCT:                        PRO/Wireless 5100 AGN [Shiloh] Network Connection
-GENERAL\&.DRIVER:                         iwlwifi
-GENERAL\&.DRIVER\-VERSION:                 3\&.8\&.13\-100\&.fc17\&.x86_64
-GENERAL\&.FIRMWARE\-VERSION:               8\&.83\&.5\&.1 build 33692
-GENERAL\&.HWADDR:                         00:1E:65:37:A1:D3
-GENERAL\&.MTU:                            1500
-GENERAL\&.STATE:                          100 (connected)
-GENERAL\&.REASON:                         0 (No reason given)
-GENERAL\&.UDI:                            /sys/devices/pci0000:00/0000:00:1c\&.1/0000:03:00\&.0/net/wlan0
-GENERAL\&.IP\-IFACE:                       wlan0
-GENERAL\&.IS\-SOFTWARE:                    no
-GENERAL\&.NM\-MANAGED:                     yes
-GENERAL\&.AUTOCONNECT:                    yes
-GENERAL\&.FIRMWARE\-MISSING:               no
-GENERAL\&.CONNECTION:                     My Alfa WiFi
-GENERAL\&.CON\-UUID:                       85194f4c\-d496\-4eec\-bae0\-d880b4cbcf26
-GENERAL\&.CON\-PATH:                       /org/freedesktop/NetworkManager/ActiveConnection/10
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-WIFI\-PROPERTIES\&.WEP:                    yes
-WIFI\-PROPERTIES\&.WPA:                    yes
-WIFI\-PROPERTIES\&.WPA2:                   yes
-WIFI\-PROPERTIES\&.TKIP:                   yes
-WIFI\-PROPERTIES\&.CCMP:                   yes
-WIFI\-PROPERTIES\&.AP:                     no
-WIFI\-PROPERTIES\&.ADHOC:                  yes
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This command shows information about a Wi\-Fi device\&.
-.PP
-\fBExample\ \&3.\ \&Listing NetworkManager polkit permissions\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli general permissions
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-PERMISSION                                                VALUE
-org\&.freedesktop\&.NetworkManager\&.enable\-disable\-network     yes
-org\&.freedesktop\&.NetworkManager\&.enable\-disable\-wifi        yes
-org\&.freedesktop\&.NetworkManager\&.enable\-disable\-wwan        yes
-org\&.freedesktop\&.NetworkManager\&.enable\-disable\-wimax       yes
-org\&.freedesktop\&.NetworkManager\&.sleep\-wake                 no
-org\&.freedesktop\&.NetworkManager\&.network\-control            yes
-org\&.freedesktop\&.NetworkManager\&.wifi\&.share\&.protected       yes
-org\&.freedesktop\&.NetworkManager\&.wifi\&.share\&.open            yes
-org\&.freedesktop\&.NetworkManager\&.settings\&.modify\&.system     yes
-org\&.freedesktop\&.NetworkManager\&.settings\&.modify\&.own        yes
-org\&.freedesktop\&.NetworkManager\&.settings\&.modify\&.hostname   auth
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This command shows configured polkit permissions for various NetworkManager operations\&. These permissions or actions (using polkit language) are configured by a system administrator and are not meant to be changed by users\&. The usual place for the polkit configuration is /usr/share/polkit\-1/actions/org\&.freedesktop\&.NetworkManager\&.policy\&.
-\fIpkaction\fR
-command can display description for polkit actions\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-pkaction \-\-action\-id org\&.freedesktop\&.NetworkManager\&.network\-control \-\-verbose
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-More information about polkit can be found at http://www\&.freedesktop\&.org/wiki/Software/polkit\&.
-.PP
-\fBExample\ \&4.\ \&Listing NetworkManager log level and domains\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli general logging
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-LEVEL  DOMAINS
-INFO   PLATFORM,RFKILL,ETHER,WIFI,BT,MB,DHCP4,DHCP6,PPP,WIFI_SCAN,IP4,IP6,AUTOIP4,DNS,VPN,SHARING,SUPPLICANT,AGENTS,SETTINGS,SUSPEND,CORE,DEVICE,OLPC,WIMAX,INFINIBAND,FIREWALL,ADSL,BOND,VLAN,BRIDGE,DBUS_PROPS,TEAM,CONCHECK,DCB,DISPATCH
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This command shows current NetworkManager logging status\&.
-.PP
-\fBExample\ \&5.\ \&Changing NetworkManager logging\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli g log level DEBUG domains CORE,ETHER,IP
-$ nmcli g log level INFO domains DEFAULT
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-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
-\fBNetworkManager.conf\fR(5)
-manual page for available logging levels and domains\&.
-.PP
-\fBExample\ \&6.\ \&Adding a bonding master and two slave connection profiles\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli con add type bond ifname mybond0 mode active\-backup
-$ nmcli con add type ethernet ifname eth1 master mybond0
-$ nmcli con add type ethernet ifname eth2 master mybond0
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This example demonstrates adding a bond master connection and two slaves\&. The first command adds a master bond connection, naming the bonding interface
-\fImybond0\fR
-and using
-\fIactive\-backup\fR
-mode\&. The next two commands add slaves connections, both enslaved to
-\fImybond0\fR\&. The first slave will be bound to
-\fIeth1\fR
-interface, the second to
-\fIeth2\fR\&.
-.PP
-\fBExample\ \&7.\ \&Adding a team master and two slave connection profiles\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli con add type team con\-name Team1 ifname Team1 config team1\-master\-json\&.conf
-$ nmcli con add type ethernet con\-name Team1\-slave1 ifname em1 master Team1
-$ nmcli con add type ethernet con\-name Team1\-slave2 ifname em2 master Team1
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-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 the team interface and the profile
-\fITeam1\fR\&. The team configuration for the master is read from
-\fIteam1\-master\-json\&.conf\fR
-file\&. Later, you can change the configuration with
-\fImodify\fR
-command (\fBnmcli con modify Team1 team\&.config team1\-master\-another\-json\&.conf\fR)\&. The last two commands add slaves profiles, both enslaved to
-\fITeam1\fR\&. The first slave will be bound to
-\fIem1\fR
-interface, the second to
-\fIem2\fR\&. The slaves don\*(Aqt specify
-\fIconfig\fR
-and thus
-\fIteamd\fR
-will use its default configuration\&. You will activate the whole setup by activating both slaves:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli con up Team1\-slave1
-$ nmcli con up Team1\-slave2
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-By default, the created profiles are marked for auto\-activation\&. But if another connection has been activated on the device, the new profile won\*(Aqt activate automatically and you need to activate it manually\&.
-.PP
-\fBExample\ \&8.\ \&Adding a bridge and two slave profiles\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fB
-$ nmcli con add type bridge con\-name TowerBridge ifname TowerBridge
-$ nmcli con add type ethernet con\-name br\-slave\-1 ifname ens3 master TowerBridge
-$ nmcli con add type ethernet con\-name br\-slave\-2 ifname ens4 master TowerBridge
-$ nmcli con modify TowerBridge bridge\&.stp no
-      \fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This example demonstrates adding a bridge master connection and two slaves\&. The first command adds a master bridge connection, naming the bridge interface and the profile as
-\fITowerBridge\fR\&. The next two commands add slaves profiles, both will be enslaved to
-\fITowerBridge\fR\&. The first slave will be tied to
-\fIens3\fR
-interface, the second to
-\fIens4\fR\&. The last command will disable 802\&.1D STP for the TowerBridge profile\&.
-.PP
-\fBExample\ \&9.\ \&Adding an ethernet connection profile with manual IP configuration\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-        \fB
-$ 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
-$ nmcli con mod my\-con\-em1 ipv4\&.dns "8\&.8\&.8\&.8 8\&.8\&.4\&.4"
-$ nmcli con mod my\-con\-em1 +ipv4\&.dns 1\&.2\&.3\&.4
-$ nmcli con mod my\-con\-em1 ipv6\&.dns "2001:4860:4860::8888 2001:4860:4860::8844"
-$ nmcli \-p con show my\-con\-em1
-        \fR
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-The first command adds an Ethernet connection profile named
-\fImy\-con\-em1\fR
-that is bound to interface name
-\fIem1\fR\&. The profile is configured with static IP addresses\&. Three addresses are added, two IPv4 addresses and one IPv6\&. The first IP 192\&.168\&.100\&.100 has a prefix of 24 (netmask equivalent of 255\&.255\&.255\&.0)\&. Gateway entry will become the default route if this profile is activated on em1 interface (and there is no connection with higher priority)\&. The next two addresses do not specify a prefix, so a default prefix will be used, i\&.e\&. 32 for IPv4 and 128 for IPv6\&. The second, third and fourth commands modify DNS parameters of the new connection profile\&. The last
-\fIcon show\fR
-command displays the profile so that all parameters can be reviewed\&.
-.PP
-\fBExample\ \&10.\ \&Escaping colon characters in tabular mode\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-        \fB
-$ nmcli \-t \-f general \-e yes \-m tab dev show eth0
-        \fR
-      
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-GENERAL:eth0:ethernet:Intel Corporation:82567LM Gigabit Network Connection:e1000e:2\&.1\&.4\-k:1\&.8\-3:00\e:22\e:68\e:15\e:29\e:21:1500:100 (connected):0 (No reason given):/sys/devices/pci0000\e:00/0000\e:00\e:19\&.0/net/eth0:eth0:yes:yes:no:ethernet\-13:89cbcbc6\-dc85\-456c\-9c8b\-bd828fee3917:/org/freedesktop/NetworkManager/ActiveConnection/9
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This example shows escaping colon characters in tabular mode\&. It may be useful for script processing, because \*(Aq:\*(Aq is used as a field separator\&.
-.PP
-\fBExample\ \&11.\ \&nmcli usage in a NetworkManager dispatcher script to make Ethernet and Wi-Fi mutually exclusive\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-#!/bin/bash
-export LC_ALL=C
-
-enable_disable_wifi ()
-{
-    result=$(nmcli dev | grep "ethernet" | grep \-w "connected")
-    if [ \-n "$result" ]; then
-        nmcli radio wifi off
-    else
-        nmcli radio wifi on
-    fi
-}
-
-if [ "$2" = "up" ]; then
-    enable_disable_wifi
-fi
-
-if [ "$2" = "down" ]; then
-    enable_disable_wifi
-fi
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This dispatcher script makes Wi\-Fi mutually exclusive with wired networking\&. When a wired interface is connected, Wi\-Fi will be set to airplane mode (rfkilled)\&. When the wired interface is disconnected, Wi\-Fi will be turned back on\&. Name this script e\&.g\&. 70\-wifi\-wired\-exclusive\&.sh and put it into /etc/NetworkManager/dispatcher\&.d/ directory\&. See
-\fBNetworkManager\fR(8)
-manual page for more information about NetworkManager dispatcher scripts\&.
-.PP
-\fBExample sessions of interactive connection editor\fR
-.PP
-\fBExample\ \&12.\ \&Adding an ethernet connection profile in interactive editor (a)\fR
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-        \fB
-$ nmcli connection edit type ethernet
-        \fR
-      
-.fi
-.if n \{\
-.RE
-.\}
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-
-===| nmcli interactive connection editor |===
-
-Adding a new \*(Aq802\-3\-ethernet\*(Aq connection
-
-Type \*(Aqhelp\*(Aq or \*(Aq?\*(Aq for available commands\&.
-Type \*(Aqdescribe [<setting>\&.<prop>]\*(Aq for detailed property description\&.
-
-You may edit the following settings: connection, 802\-3\-ethernet (ethernet), 802\-1x, ipv4, ipv6, dcb
-nmcli> print
-===============================================================================
-                              Connection details
-===============================================================================
-connection\&.id:                          ethernet\-4
-connection\&.uuid:                        de89cdeb\-a3e1\-4d53\-8fa0\-c22546c775f4
-connection\&.interface\-name:              \-\-
-connection\&.type:                        802\-3\-ethernet
-connection\&.autoconnect:                 yes
-connection\&.autoconnect\-priority:        0
-connection\&.timestamp:                   0
-connection\&.read\-only:                   no
-connection\&.permissions:                 
-connection\&.zone:                        \-\-
-connection\&.master:                      \-\-
-connection\&.slave\-type:                  \-\-
-connection\&.secondaries:                 
-connection\&.gateway\-ping\-timeout:        0
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-802\-3\-ethernet\&.port:                    \-\-
-802\-3\-ethernet\&.speed:                   0
-802\-3\-ethernet\&.duplex:                  \-\-
-802\-3\-ethernet\&.auto\-negotiate:          yes
-802\-3\-ethernet\&.mac\-address:             \-\-
-802\-3\-ethernet\&.cloned\-mac\-address:      \-\-
-802\-3\-ethernet\&.mac\-address\-blacklist:   
-802\-3\-ethernet\&.mtu:                     auto
-802\-3\-ethernet\&.s390\-subchannels:        
-802\-3\-ethernet\&.s390\-nettype:            \-\-
-802\-3\-ethernet\&.s390\-options:            
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv4\&.method:                            auto
-ipv4\&.dns:                               
-ipv4\&.dns\-search:                        
-ipv4\&.addresses:                         
-ipv4\&.gateway:                           \-\-
-ipv4\&.routes:                            
-ipv4\&.route\-metric:                      \-1
-ipv4\&.ignore\-auto\-routes:                no
-ipv4\&.ignore\-auto\-dns:                   no
-ipv4\&.dhcp\-client\-id:                    \-\-
-ipv4\&.dhcp\-send\-hostname:                yes
-ipv4\&.dhcp\-hostname:                     \-\-
-ipv4\&.never\-default:                     no
-ipv4\&.may\-fail:                          yes
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv6\&.method:                            auto
-ipv6\&.dns:                               
-ipv6\&.dns\-search:                        
-ipv6\&.addresses:                         
-ipv6\&.gateway:                           \-\-
-ipv6\&.routes:                            
-ipv6\&.route\-metric:                      \-1
-ipv6\&.ignore\-auto\-routes:                no
-ipv6\&.ignore\-auto\-dns:                   no
-ipv6\&.never\-default:                     no
-ipv6\&.may\-fail:                          yes
-ipv6\&.ip6\-privacy:                       \-1 (unknown)
-ipv6\&.dhcp\-hostname:                     \-\-
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-nmcli> goto ethernet
-You may edit the following properties: port, speed, duplex, auto\-negotiate, mac\-address, cloned\-mac\-address, mac\-address\-blacklist, mtu, s390\-subchannels, s390\-nettype, s390\-options
-nmcli 802\-3\-ethernet> set mtu 1492
-nmcli 802\-3\-ethernet> b
-nmcli> goto ipv4\&.addresses
-nmcli ipv4\&.addresses> desc
-
-=== [addresses] ===
-[NM property description]
-Array of IP addresses\&.
-
-[nmcli specific description]
-Enter a list of IPv4 addresses formatted as:
-  ip[/prefix], ip[/prefix],\&.\&.\&.
-Missing prefix is regarded as prefix of 32\&.
-
-Example: 192\&.168\&.1\&.5/24, 10\&.0\&.0\&.11/24
-
-nmcli ipv4\&.addresses> set 192\&.168\&.1\&.100/24
-Do you also want to set \*(Aqipv4\&.method\*(Aq to \*(Aqmanual\*(Aq? [yes]: yes
-nmcli ipv4\&.addresses>
-nmcli ipv4\&.addresses> print
-addresses: 192\&.168\&.1\&.100/24
-nmcli ipv4\&.addresses> back
-nmcli ipv4> b
-nmcli> set ipv4\&.gateway 192\&.168\&.1\&.1
-nmcli> verify
-Verify connection: OK
-nmcli> print
-===============================================================================
-                              Connection details
-===============================================================================
-connection\&.id:                          ethernet\-4
-connection\&.uuid:                        de89cdeb\-a3e1\-4d53\-8fa0\-c22546c775f4
-connection\&.interface\-name:              \-\-
-connection\&.type:                        802\-3\-ethernet
-connection\&.autoconnect:                 yes
-connection\&.autoconnect\-priority:        0
-connection\&.timestamp:                   0
-connection\&.read\-only:                   no
-connection\&.permissions:                 
-connection\&.zone:                        \-\-
-connection\&.master:                      \-\-
-connection\&.slave\-type:                  \-\-
-connection\&.secondaries:                 
-connection\&.gateway\-ping\-timeout:        0
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-802\-3\-ethernet\&.port:                    \-\-
-802\-3\-ethernet\&.speed:                   0
-802\-3\-ethernet\&.duplex:                  \-\-
-802\-3\-ethernet\&.auto\-negotiate:          yes
-802\-3\-ethernet\&.mac\-address:             \-\-
-802\-3\-ethernet\&.cloned\-mac\-address:      \-\-
-802\-3\-ethernet\&.mac\-address\-blacklist:   
-802\-3\-ethernet\&.mtu:                     1492
-802\-3\-ethernet\&.s390\-subchannels:        
-802\-3\-ethernet\&.s390\-nettype:            \-\-
-802\-3\-ethernet\&.s390\-options:            
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv4\&.method:                            manual
-ipv4\&.dns:                               
-ipv4\&.dns\-search:                        
-ipv4\&.addresses:                         192\&.168\&.1\&.100/24
-ipv4\&.gateway:                           192\&.168\&.1\&.1
-ipv4\&.routes:                            
-ipv4\&.route\-metric:                      \-1
-ipv4\&.ignore\-auto\-routes:                no
-ipv4\&.ignore\-auto\-dns:                   no
-ipv4\&.dhcp\-client\-id:                    \-\-
-ipv4\&.dhcp\-send\-hostname:                yes
-ipv4\&.dhcp\-hostname:                     \-\-
-ipv4\&.never\-default:                     no
-ipv4\&.may\-fail:                          yes
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv6\&.method:                            auto
-ipv6\&.dns:                               
-ipv6\&.dns\-search:                        
-ipv6\&.addresses:                         
-ipv6\&.routes:                            
-ipv6\&.route\-metric:                      \-1
-ipv6\&.ignore\-auto\-routes:                no
-ipv6\&.ignore\-auto\-dns:                   no
-ipv6\&.never\-default:                     no
-ipv6\&.may\-fail:                          yes
-ipv6\&.ip6\-privacy:                       \-1 (unknown)
-ipv6\&.dhcp\-hostname:                     \-\-
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-nmcli> set ipv4\&.dns 8\&.8\&.8\&.8 8\&.8\&.4\&.4
-nmcli> print
-===============================================================================
-                              Connection details
-===============================================================================
-connection\&.id:                          ethernet\-4
-connection\&.uuid:                        de89cdeb\-a3e1\-4d53\-8fa0\-c22546c775f4
-connection\&.interface\-name:              \-\-
-connection\&.type:                        802\-3\-ethernet
-connection\&.autoconnect:                 yes
-connection\&.autoconnect\-priority:        0
-connection\&.timestamp:                   0
-connection\&.read\-only:                   no
-connection\&.permissions:                 
-connection\&.zone:                        \-\-
-connection\&.master:                      \-\-
-connection\&.slave\-type:                  \-\-
-connection\&.secondaries:                 
-connection\&.gateway\-ping\-timeout:        0
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-802\-3\-ethernet\&.port:                    \-\-
-802\-3\-ethernet\&.speed:                   0
-802\-3\-ethernet\&.duplex:                  \-\-
-802\-3\-ethernet\&.auto\-negotiate:          yes
-802\-3\-ethernet\&.mac\-address:             \-\-
-802\-3\-ethernet\&.cloned\-mac\-address:      \-\-
-802\-3\-ethernet\&.mac\-address\-blacklist:   
-802\-3\-ethernet\&.mtu:                     1492
-802\-3\-ethernet\&.s390\-subchannels:        
-802\-3\-ethernet\&.s390\-nettype:            \-\-
-802\-3\-ethernet\&.s390\-options:            
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv4\&.method:                            manual
-ipv4\&.dns:                               8\&.8\&.8\&.8,8\&.8\&.4\&.4
-ipv4\&.dns\-search:                        
-ipv4\&.addresses:                         192\&.168\&.1\&.100/24
-ipv4\&.gateway:                           192\&.168\&.1\&.1
-ipv4\&.routes:                            
-ipv4\&.route\-metric:                      \-1
-ipv4\&.ignore\-auto\-routes:                no
-ipv4\&.ignore\-auto\-dns:                   no
-ipv4\&.dhcp\-client\-id:                    \-\-
-ipv4\&.dhcp\-send\-hostname:                yes
-ipv4\&.dhcp\-hostname:                     \-\-
-ipv4\&.never\-default:                     no
-ipv4\&.may\-fail:                          yes
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-ipv6\&.method:                            auto
-ipv6\&.dns:                               
-ipv6\&.dns\-search:                        
-ipv6\&.addresses:                         
-ipv6\&.gateway:                           \-\-
-ipv6\&.routes:                            
-ipv6\&.route\-metric:                      \-1
-ipv6\&.ignore\-auto\-routes:                no
-ipv6\&.ignore\-auto\-dns:                   no
-ipv6\&.never\-default:                     no
-ipv6\&.may\-fail:                          yes
-ipv6\&.ip6\-privacy:                       \-1 (unknown)
-ipv6\&.dhcp\-hostname:                     \-\-
-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
-nmcli> verify
-Verify connection: OK
-nmcli> save
-Connection \*(Aqethernet\-4\*(Aq (de89cdeb\-a3e1\-4d53\-8fa0\-c22546c775f4) successfully saved\&.
-nmcli> quit
-      
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-Example session in the nmcli interactive connection editor\&. The scenario creates an Ethernet connection profile with static addressing (IPs and DNS)\&.
-.SH "SEE ALSO"
-.PP
-\fBnmcli\fR(1),
-\fBNetworkManager\fR(8),
-\fBNetworkManager.conf\fR(5),
-\fBnm-settings\fR(5),
-\fBnm-online\fR(1),
-\fBnm-applet\fR(1),
-\fBnm-connection-editor\fR(1)