path: root/man/nmcli-examples.5

'\" t
.\"     Title: nmcli-examples
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 16 June 2014
.\"    Manual: Examples
.\"    Source: NetworkManager 0.9.10
.\"  Language: English
.\"
.TH "NMCLI\-EXAMPLES" "5" "" "NetworkManager 0\&.9\&.10" "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\&.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 bond\-slave ifname eth1 master mybond0
$ nmcli con add type bond\-slave 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 team\-slave con\-name Team1\-slave1 ifname em1 master Team1
$ nmcli con add type team\-slave 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 bridge\-slave con\-name br\-slave\-1 ifname ens3 master TowerBridge
$ nmcli con add type bridge\-slave 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 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 for the first IP address will become the default route if this profile is activated on em1 interface (and there is no connection with higher priority)\&. The second two addresses don\*(Aqt specify a prefix, so a default prefix will be used, i\&.e\&. 32 for IPv4 and 128 for IPv6\&. The second and third 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\&.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\&.routes:                            
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\&.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 IPv4 address structures\&.  Each IPv4 address structure is composed of 3 32\-bit values; the first being the IPv4 address (network byte order), the second the prefix (1 \- 32), and last the IPv4 gateway (network byte order)\&. The gateway may be left as 0 if no gateway exists for that subnet\&.  For the \*(Aqauto\*(Aq method, given IP addresses are appended to those returned by automatic configuration\&.  Addresses cannot be used with the \*(Aqshared\*(Aq, \*(Aqlink\-local\*(Aq, or \*(Aqdisabled\*(Aq methods as addressing is either automatic or disabled with these methods\&.

[nmcli specific description]
Enter a list of IPv4 addresses formatted as:
  ip[/prefix] [gateway], ip[/prefix] [gateway],\&.\&.\&.
Missing prefix is regarded as prefix of 32\&.

Example: 192\&.168\&.1\&.5/24 192\&.168\&.1\&.1, 10\&.0\&.0\&.11/24

nmcli ipv4\&.addresses> set 192\&.168\&.1\&.100/24 192\&.168\&.1\&.1
Do you also want to set \*(Aqipv4\&.method\*(Aq to \*(Aqmanual\*(Aq? [yes]: yes
nmcli ipv4\&.addresses>
nmcli ipv4\&.addresses> print
addresses: { ip = 192\&.168\&.1\&.100/24, gw = 192\&.168\&.1\&.1 }
nmcli ipv4\&.addresses> back
nmcli ipv4> b
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\&.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:                         { ip = 192\&.168\&.1\&.100/24, gw = 192\&.168\&.1\&.1 }
ipv4\&.routes:                            
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\&.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\&.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:                         { ip = 192\&.168\&.1\&.100/24, gw = 192\&.168\&.1\&.1 }
ipv4\&.routes:                            
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\&.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 (configuration) 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)