Imported Upstream version 1.4.0 upstream/1.4.0

1 files changed, 1309 insertions, 621 deletions

diff --git a/man/nmcli.1 b/man/nmcli.1
index e0b9e527..2eaef626 100644
--- a/man/nmcli.1
+++ b/man/nmcli.1
@@ -2,12 +2,12 @@
 .\"     Title: nmcli
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\"      Date: 08/03/2016
+.\"      Date: 08/24/2016
 .\"    Manual: General Commands Manual
-.\"    Source: NetworkManager 1.2.4
+.\"    Source: NetworkManager 1.4.0
 .\"  Language: English
 .\"
-.TH "NMCLI" "1" "" "NetworkManager 1\&.2\&.4" "General Commands Manual"
+.TH "NMCLI" "1" "" "NetworkManager 1\&.4\&.0" "General Commands Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -140,7 +140,7 @@ only produces colors when standard output is directed to a terminal\&. The defau
 auto\&.
 .RE
 .PP
-\fB\-f\fR | \fB\-\-fields\fR {[\fIfield\fR...] | all | common}
+\fB\-f\fR | \fB\-\-fields\fR {\fIfield1\fR,\fIfield2\fR... | all | common}
 .RS 4
 This option is used to specify what fields (column names) should be printed\&. Valid field names differ for specific commands\&. List available fields by providing an invalid value to the
 \fB\-\-fields\fR
@@ -187,7 +187,7 @@ When using this option
 will display passwords and secrets that might be present in an output of an operation\&. This option also influences echoing passwords typed by user as an input\&.
 .RE
 .PP
-[\fB\-w\fR\ |\ \fB\-\-wait\fR\ \fIseconds\fR...]
+\fB\-w\fR | \fB\-\-wait\fR \fIseconds\fR
 .RS 4
 This option sets a timeout period for which
 \fBnmcli\fR
@@ -200,6 +200,19 @@ instructs
 not to wait but to exit immediately with a status of success\&. The default value depends on the executed command\&.
 .RE
 .PP
+\fB\-\-complete\-args\fR
+.RS 4
+Instead of conducting the desired action,
+\fBnmcli\fR
+will list possible completions for the last argument\&. This is useful to implement argument completion in shell\&.
+.sp
+The
+exit status
+will indicate success or return a code 65 to indicate the last argument is a file name\&.
+.sp
+NetworkManager ships with command completion support for GNU Bash\&.
+.RE
+.PP
 \fB\-v\fR | \fB\-\-version\fR
 .RS 4
 Show
@@ -239,7 +252,7 @@ file when it starts\&.
 Show the permissions a caller has for various authenticated operations that NetworkManager provides, like enable and disable networking, changing Wi\-Fi and WWAN state, modifying connections, etc\&.
 .RE
 .PP
-\fBlogging\fR [\fBlevel\fR\ \fIlevel\fR] [\fBdomain\fR\ \fIdomains\fR...]
+\fBlogging\fR [\fBlevel\fR\ \fIlevel\fR] [\fBdomains\fR\ \fIdomains\fR...]
 .RS 4
 Get and change NetworkManager logging level and domains\&. Without any argument current logging level and domains are shown\&. In order to change logging state, provide
 \fBlevel\fR
@@ -334,7 +347,7 @@ and
 to watch for changes in certain devices or connections\&.
 .SH "CONNECTION MANAGEMENT COMMANDS"
 .HP \w'\fBnmcli\ connection\fR\ 'u
-\fBnmcli connection\fR {\fBshow\fR | \fBup\fR | \fBdown\fR | \fBadd\fR | \fBedit\fR | \fBmodify\fR | \fBdelete\fR | \fBmonitor\fR | \fBreload\fR | \fBload\fR} [\fIARGUMENTS\fR...]
+\fBnmcli connection\fR {\fBshow\fR | \fBup\fR | \fBdown\fR | \fBmodify\fR | \fBadd\fR | \fBedit\fR | \fBclone\fR | \fBdelete\fR | \fBmonitor\fR | \fBreload\fR | \fBload\fR | \fBimport\fR | \fBexport\fR} [\fIARGUMENTS\fR...]
 .PP
 NetworkManager stores all network configuration as "connections", which are collections of data (Layer2 details, IP addressing, etc\&.) that describe how to create or connect to a network\&. A connection is "active" when a device uses that connection\*(Aqs configuration to create or connect to a network\&. There may be multiple connections that apply to a device, but only one of them can be active on that device at any given time\&. The additional connections can be used to allow quick switching between different networks and configurations\&.
 .PP
@@ -435,7 +448,7 @@ When no command is given to the
 \fBnmcli connection show\fR\&.
 .RE
 .PP
-\fBup\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR... [\fBifname\fR\ \fIifname\fR] [\fBap\fR\ \fIBSSID\fR] [\fBpasswd\-file\fR\ \fIfile\fR]
+\fBup\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR [\fBifname\fR\ \fIifname\fR] [\fBap\fR\ \fIBSSID\fR] [\fBpasswd\-file\fR\ \fIfile\fR]
 .RS 4
 Activate a connection\&. The connection is identified by its name, UUID or D\-Bus path\&. If
 \fIID\fR
@@ -561,634 +574,330 @@ If
 option is not specified, the default timeout will be 10 seconds\&.
 .RE
 .PP
-\fBadd\fR \fBifname\fR\ \fIifname\fR [con\-name\ \fIname\fR] [\fBautoconnect\fR\ {yes\ |\ no}] [\fBsave\fR\ {yes\ |\ no}] [master\ \fImaster\fR] [slave\-type\ \fItype\fR] [type\ \fItype\fR] [\fIARGUMENTS\fR...] [ip4\ \fIaddr\fR] [gw4\ \fIaddr\fR] [ip6\ \fIaddr\fR] [gw6\ \fIaddr\fR] [\fB\-\-\fR\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR\ ...]
-.RS 4
-Add a connection for NetworkManager\&. Arguments differ according to connection types, see below\&.
-.PP
-\fBifname\fR
-.RS 4
-interface to bind the connection to\&. The connection will only be applicable to this interface name\&. A special value of
-*
-can be used for interface\-independent connections\&. The
-\fBifname\fR
-argument is mandatory for all connection types except bond, team, bridge and vlan\&. Note: use quotes around
-*
-to suppress shell expansion\&.
-.RE
-.PP
-\fBcon\-name\fR
-.RS 4
-connection name (when not provided a default name is generated: <type>[\-<ifname>][\-<num>])\&.
-.RE
-.PP
-\fBautoconnect\fR
+\fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
 .RS 4
-whether the connection profile can be automatically activated (default: yes)\&.
-.RE
-.PP
-\fBsave\fR
-.RS 4
-whether the connection should be persistent, i\&.e\&. NetworkManager should store it on disk (default:
-yes)\&.
-.RE
-.PP
-\fBmaster\fR
-.RS 4
-master interface name, or connection UUID or ID of master connection profile\&. The value can be prefixed with
-ifname/,
-uuid/
+Add, modify or remove properties in the connection profile\&.
+.sp
+To set the property just specify the property name followed by the value\&. An empty value ("") removes the property value\&.
+.sp
+In addition to the properties, you can also use short names for some of the properties\&. Consult the
+PROPERTY ALIASES
+section for details\&.
+.sp
+If you want to append an item to the existing value, use
++
+prefix for the property name\&. If you want to remove just one item from container\-type property, use
+\-
+prefix for the property name and specify a value or an zero\-based index of the item to remove (or option name for properties with named options) as
+\fIvalue\fR\&. The
++
+and
+\-
+modifies only have a real effect for multi\-value (container) properties like
+ipv4\&.dns,
+ipv4\&.addresses,
+bond\&.options, etc\&.
+.sp
+See
+\fBnm-settings\fR(5)
+for complete reference of setting and property names, their descriptions and default values\&. The
+\fIsetting\fR
+and
+\fIproperty\fR
+can be abbreviated provided they are unique\&.
+.sp
+The connection is identified by its name, UUID or D\-Bus path\&. If
+\fIID\fR
+is ambiguous, a keyword
+\fBid\fR,
+\fBuuid\fR
 or
-id/
-to disambiguate it\&.
+\fBpath\fR
+can be used\&.
 .RE
 .PP
-\fBslave\-type\fR
+\fBadd\fR [\fBsave\fR\ {yes\ |\ no}] {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
 .RS 4
-type of master connection\&. Only required when it can not be inferred (i\&.e\&. the master connection does not exist yet)\&.
-.RE
-.PP
+Create a new connection using specified properties\&.
+.sp
+You need to describe the newly created connections with the property and value pairs\&. See
+\fBnm-settings\fR(5)
+for the complete reference\&. You can also use the aliases described in
+PROPERTY ALIASES
+section\&. The syntax is the same as of the
+\fBnmcli connection modify\fR
+command\&.
+.sp
+To construct a meaningful connection you at the very least need to set the
+\fBconnection\&.type\fR
+property (or use the
 \fBtype\fR
+alias) to one of known NetworkManager connection types:
+.sp
 .RS 4
-connection type; see below for allowed values\&. Note that types
-\fBbond\-slave\fR,
-\fBteam\-slave\fR
-and
-\fBbridge\-slave\fR
-create
-\fBethernet\fR
-connection profiles\&. Their use is discouraged in favor of using a specific type with
-\fBmaster\fR
-option\&.
-.RE
-.PP
-\fBtype ethernet\fR [\fBmac\fR\ \fIaddr\fR] [\fBcloned\-mac\fR\ \fIaddr\fR] [\fBmtu\fR\ \fImtu\fR]
-.RS 4
-.PP
-\fBmac\fR
-.RS 4
-MAC address of the device this connection is locked to\&.
-.RE
-.PP
-\fBcloned\-mac\fR
-.RS 4
-cloned MAC\&.
-.RE
-.PP
-\fBmtu\fR
-.RS 4
-MTU\&.
-.RE
-.RE
-.PP
-\fBtype wifi\fR \fBssid\fR\ \fISSID\fR [\fBmac\fR\ \fIaddr\fR] [\fBcloned\-mac\fR\ \fIaddr\fR] [\fBmode\fR\ {infrastructure\ |\ ap\ |\ adhoc}] [\fBmtu\fR\ \fImtu\fR]
-.RS 4
-.PP
-\fBssid\fR
-.RS 4
-SSID\&.
-.RE
-.PP
-\fBmac\fR
-.RS 4
-MAC address of the device this connection is locked to\&.
-.RE
-.PP
-\fBcloned\-mac\fR
-.RS 4
-cloned MAC\&.
-.RE
-.PP
-\fBmode\fR
-.RS 4
-Wi\-Fi network mode\&. If blank,
-infrastructure
-is assumed\&.
-.RE
-.PP
-\fBmtu\fR
-.RS 4
-MTU\&.
-.RE
-.RE
-.PP
-\fBtype wimax\fR [\fBmac\fR\ \fIaddr\fR] [\fBnsp\fR\ \fInsp\fR]
-.RS 4
-.PP
-\fBmac\fR
-.RS 4
-MAC address of the device this connection is locked to\&.
-.RE
-.PP
-\fBnsp\fR
-.RS 4
-Network Service Provider name\&.
-.RE
-.RE
-.PP
-\fBtype pppoe\fR \fBusername\fR\ \fIuser\fR [\fBpassword\fR\ \fIpasswd\fR] [\fBservice\fR\ \fIname\fR] [\fBmtu\fR\ \fImtu\fR] [\fBmac\fR\ \fIaddr\fR]
-.RS 4
-.PP
-\fBusername\fR
-.RS 4
-PPPoE username\&.
-.RE
-.PP
-\fBpassword\fR
-.RS 4
-Password for the PPPoE username\&.
-.RE
-.PP
-\fBservice\fR
-.RS 4
-PPPoE service name (if required by concentrator)\&.
-.RE
-.PP
-\fBmtu\fR
-.RS 4
-MTU\&.
-.RE
-.PP
-\fBmac\fR
-.RS 4
-MAC address of the device this connection is locked to\&.
-.RE
-.RE
-.PP
-\fBtype gsm\fR [\fBapn\fR\ \fIAPN\fR] [\fBusername\fR\ \fIuser\fR] [\fBpassword\fR\ \fIpasswd\fR]
-.RS 4
-.PP
-\fBapn\fR
-.RS 4
-APN \- GSM Access Point Name\&.
-.RE
-.PP
-\fBuser\fR
-.RS 4
-user name\&.
-.RE
-.PP
-\fBpassword\fR
-.RS 4
-password\&.
-.RE
-.RE
-.PP
-\fBtype cdma\fR [\fBusername\fR\ \fIuser\fR] [\fBpassword\fR\ \fIpasswd\fR]
-.RS 4
-.PP
-\fBuser\fR
-.RS 4
-user name\&.
-.RE
-.PP
-\fBpassword\fR
-.RS 4
-password\&.
-.RE
-.RE
-.PP
-\fBtype infiniband\fR [\fBmac\fR\ \fIaddr\fR] [\fBmtu\fR\ \fImtu\fR] [\fBtransport\-mode\fR\ {datagram\ |\ connected}] [\fBparent\fR\ \fIdevice\fR] [\fBp\-key\fR\ \fIkey\fR]
-.RS 4
-.PP
-\fBmac\fR
-.RS 4
-MAC address of the device this connection is locked to (InfiniBand MAC is 20 bytes)\&.
-.RE
-.PP
-\fBmtu\fR
-.RS 4
-MTU\&.
-.RE
-.PP
-\fBtransport\-mode\fR
-.RS 4
-InfiniBand transport mode\&.
-.RE
-.PP
-\fBparent\fR
-.RS 4
-the interface name of the parent device (if any)\&.
-.RE
-.PP
-\fBp\-key\fR
-.RS 4
-the InfiniBand P_Key (16\-bit unsigned integer)\&.
-.RE
-.RE
-.PP
-\fBtype bluetooth\fR [\fBaddr\fR\ \fIaddr\fR] [\fBbt\-type\fR\ {panu\ |\ dun\-gsm\ |\ dun\-cdma}]
-.RS 4
-.PP
-\fBaddr\fR
-.RS 4
-Bluetooth device address (MAC)\&.
-.RE
-.PP
-\fBbt\-type\fR
-.RS 4
-Bluetooth connection type\&.
-.RE
-.RE
-.PP
-\fBtype vlan\fR \fBdev\fR\ \fIdevice\fR \fBid\fR\ \fIid\fR [\fBflags\fR\ \fIflags\fR] [\fBingress\fR\ \fImapping\fR] [\fBegress\fR\ \fImapping\fR] [\fBmtu\fR\ \fImtu\fR]
-.RS 4
-.PP
-\fBdev\fR
-.RS 4
-parent device this VLAN is on\&.
-.RE
-.PP
-\fBid\fR
-.RS 4
-VLAN ID in range 0\-4095\&.
-.RE
-.PP
-\fBflags\fR
-.RS 4
-flags\&.
-.RE
-.PP
-\fBingress\fR
-.RS 4
-VLAN ingress priority mapping\&.
-.RE
-.PP
-\fBegress\fR
-.RS 4
-VLAN egress priority mapping\&.
-.RE
-.PP
-\fBmtu\fR
-.RS 4
-MTU\&.
-.RE
-.RE
-.PP
-\fBtype bond\fR [\fBmode\fR\ {active\-backup\ |\ balance\-xor\ |\ broadcast\ |\ 802\&.3ad\ |\ balance\-tlb\ |\ balance\-alb\ |\ \fInum\fR}] [\fBprimary\fR\ \fIifname\fR] [\fBmiimon\fR\ \fInum\fR] [\fBdowndelay\fR\ \fInum\fR] [\fBupdelay\fR\ \fInum\fR] [\fBarp\-interval\fR\ \fInum\fR] [\fBarp\-ip\-target\fR\ \fInum\fR]
-.RS 4
-.PP
-\fBmode\fR
-.RS 4
-bonding mode (default:
-balance\-rr)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+ethernet
 .RE
-.PP
-\fBprimary\fR
+.sp
 .RS 4
-primary interface name (for
-active\-backup
-mode)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+wifi
 .RE
-.PP
-\fBmiimon\fR
+.sp
 .RS 4
-miimon (default:
-100)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+wimax
 .RE
-.PP
-\fBdowndelay\fR
+.sp
 .RS 4
-downdelay (default:
-0)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+pppoe
 .RE
-.PP
-\fBupdelay\fR
+.sp
 .RS 4
-updelay (default:
-0)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+gsm
 .RE
-.PP
-\fBarp\-interval\fR
+.sp
 .RS 4
-ARP interval (default:
-0)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+cdma
 .RE
-.PP
-\fBarp\-ip\-target\fR
+.sp
 .RS 4
-ARP IP target\&.
-.RE
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+infiniband
 .RE
-.PP
-\fBtype bond\-slave\fR [\fBmaster\fR\ \fImaster\fR]
-.RS 4
-.PP
-\fBmaster\fR
+.sp
 .RS 4
-master bond interface name, or connection UUID or ID of bond master connection profile\&. The value can be prefixed with
-ifname/,
-uuid/
-or
-id/
-to disambiguate it\&.
-.RE
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+bluetooth
 .RE
-.PP
-\fBtype team\fR [\fBconfig\fR\ {file\ |\ \fIJSON\fR}]
-.RS 4
-.PP
-\fBconfig\fR
+.sp
 .RS 4
-JSON configuration for team\&.
-.RE
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+vlan
 .RE
-.PP
-\fBtype team\-slave\fR [\fBconfig\fR\ \fB\fIJSON\fR\fR]
-.RS 4
-.PP
-\fBmaster\fR
+.sp
 .RS 4
-master team interface name, or connection UUID or ID of team master connection profile\&. The value can be prefixed with
-ifname/,
-uuid/
-or
-id/to disambiguate it\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+bond
 .RE
-.PP
-\fBconfig\fR
+.sp
 .RS 4
-JSON configuration for team\&.
-.RE
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+bond\-slave
 .RE
-.PP
-\fBtype bridge\fR [\fBstp\fR\ {yes\ |\ no}] [\fBpriority\fR\ \fInum\fR] [\fBforward\-delay\fR\ \fI2\-30\fR] [\fBhello\-time\fR\ \fI1\-10\fR] [\fBmax\-age\fR\ \fI6\-42\fR] [\fBageing\-time\fR\ \fI0\-1000000\fR] [\fBmulticast\-snooping\fR\ {yes\ |\ no}] [\fBmac\fR\ \fIaddr\fR]
-.RS 4
-.PP
-\fBstp\fR
+.sp
 .RS 4
-controls whether Spanning Tree Protocol (STP) is enabled for this bridge (default:
-yes)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+team
 .RE
-.PP
-\fBpriority\fR
+.sp
 .RS 4
-sets STP priority (default:
-128)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+team\-slave
 .RE
-.PP
-\fBforward\-delay\fR
+.sp
 .RS 4
-STP forwarding delay, in seconds (default:
-15)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+bridge
 .RE
-.PP
-\fBhello\-time\fR
+.sp
 .RS 4
-STP hello time, in seconds (default:
-2)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+bridge\-slave
 .RE
-.PP
-\fBmax\-age\fR
+.sp
 .RS 4
-STP maximum message age, in seconds (default:
-20)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+vpn
 .RE
-.PP
-\fBageing\-time\fR
+.sp
 .RS 4
-the Ethernet MAC address aging time, in seconds (default:
-300)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+olpc\-mesh
 .RE
-.PP
-\fBmulticast\-snooping\fR
+.sp
 .RS 4
-controls whether IGMP snooping is enabled (default:
-yes)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+adsl
 .RE
-.PP
-\fBmac\fR
+.sp
 .RS 4
-MAC address of the bridge (note: this requires a recent kernel feature, originally introduced in 3\&.15 upstream kernel)\&.
-.RE
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+tun
 .RE
-.PP
-\fBtype bridge\-slave\fR [\fBmaster\fR\ \fImaster\fR] [\fBpriority\fR\ \fInum\fR] [\fBpath\-cost\fR\ \fI1\-65535\fR] [\fBhairpin\fR\ {yes\ |\ no}]
-.RS 4
-.PP
-\fBmaster\fR
+.sp
 .RS 4
-master bridge interface name, or connection UUID or ID of bridge master connection profile\&. The value can be prefixed with
-ifname/,
-uuid/
-or
-id/
-to disambiguate it\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+ip\-tunnel
 .RE
-.PP
-\fBpriority\fR
+.sp
 .RS 4
-STP priority of this slave (default:
-32)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+macvlan
 .RE
-.PP
-\fBpath\-cost\fR
+.sp
 .RS 4
-STP port cost for destinations via this slave (default:
-100)\&.
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+vxlan
 .RE
+.sp
+The most typical uses are described in the
+EXAMPLES
+section\&.
+.sp
+Aside from the properties and values two special options are accepted:
 .PP
-\fBhairpin\fR
+\fBsave\fR
 .RS 4
-\*(Aqhairpin mode\*(Aq for the slave, which allows frames to be sent back out through the slave the frame was received on (default:
+Controls whether the connection should be persistent, i\&.e\&. NetworkManager should store it on disk (default:
 yes)\&.
 .RE
-.RE
-.PP
-\fBtype vpn\fR [\fBtype\fR\ \fItype\fR] [\fBuser\fR\ \fIusername\fR]
-.RS 4
-.PP
-\fBvpn\-type\fR
-.RS 4
-VPN type\&.
-.RE
-.PP
-\fBuser\fR
-.RS 4
-VPN username\&.
-.RE
-.RE
-.PP
-\fBtype olpc\-mesh\fR \fBssid\fR\ \fISSID\fR [\fBchannel\fR\ \fI1\-13\fR] [\fBdhcp\-anycast\fR\ \fIMAC\fR]
-.RS 4
-.PP
-\fBssid\fR
-.RS 4
-SSID\&.
-.RE
-.PP
-\fBchannel\fR
-.RS 4
-channel to use for the network\&.
-.RE
-.PP
-\fBdhcp\-anycast\fR
-.RS 4
-anycast DHCP MAC address used when requesting an IP address via DHCP\&.
-.RE
-.RE
-.PP
-\fBtype adsl\fR \fBusername\fR\ \fIusername\fR \fBprotocol\fR\ {pppoa\ |\ pppoe\ |\ ipoatm} [\fBpassword\fR\ \fIpasswd\fR] [\fBencapsulation\fR\ {vcmux\ |\ llc}]
-.RS 4
-.PP
-\fBusername\fR
-.RS 4
-ADSL user name\&.
-.RE
-.PP
-\fBprotocol\fR
-.RS 4
-ADSL protocol\&.
-.RE
-.PP
-\fBpassword\fR
-.RS 4
-ADSL password\&.
-.RE
-.PP
-\fBencapsulation\fR
-.RS 4
-ADSL encapsulation\&.
-.RE
-.RE
-.PP
-\fBtype tun\fR \fBmode\fR\ {tun\ |\ tap} [\fBowner\fR\ \fIUID\fR] [\fBgroup\fR\ \fIGID\fR] [\fBpi\fR\ {yes\ |\ no}] [\fBvnet\-hdr\fR\ {yes\ |\ no}] [\fBmulti\-queue\fR\ {yes\ |\ no}]
-.RS 4
-.PP
-\fBmode\fR
-.RS 4
-Mode for the device\&.
-.RE
-.PP
-\fBowner\fR
-.RS 4
-UID of the owner\&.
-.RE
-.PP
-\fBgroup\fR
-.RS 4
-GID of the group\&.
-.RE
-.PP
-\fBpi\fR
-.RS 4
-include packet information (~IFF_NO_PI flag)\&.
-.RE
-.PP
-\fBvnet\-hdr\fR
-.RS 4
-send and receive large (i\&.e\&. GSO) packets and packets with partial checksums (IFF_VNET_HDR flag)\&.
-.RE
-.PP
-\fBmulti\-queue\fR
-.RS 4
-multi\-queue support for tun/tap device (IFF_MULTI_QUEUE flag)\&.
-.RE
-.RE
-.PP
-\fBtype ip\-tunnel\fR \fBmode\fR\ {ipip\ |\ gre\ |\ sit\ |\ isatap\ |\ vti\ |\ ip6ip6\ |\ ipip6\ |\ ip6gre\ |\ vti6\ |\ tun} \fBremote\fR\ \fIaddr\fR [\fBlocal\fR\ \fIaddr\fR] [\fBdev\fR\ \fIdevice\fR]
-.RS 4
-.PP
-\fBmode\fR
-.RS 4
-tunnel mode\&.
-.RE
-.PP
-\fBremote\fR
-.RS 4
-IPv4 or IPv6 address of the remote tunnel endpoint\&.
-.RE
-.PP
-\fBlocal\fR
-.RS 4
-IPv4 or IPv6 address of the local tunnel endpoint\&.
-.RE
-.PP
-\fBdev\fR
-.RS 4
-device to use for tunnel endpoint communication\&.
-.RE
-.RE
-.PP
-\fBtype macvlan\fR \fBdev\fR\ \fIdevice\fR \fBmode\fR\ {vepa\ |\ bridge\ |\ private\ |\ passthru\ |\ source} [\fBtap\fR\ {yes\ |\ no}]
-.RS 4
-.PP
-\fBdev\fR
-.RS 4
-parent device this MACVLAN is on\&.
-.RE
-.PP
-\fBmode\fR
-.RS 4
-MACVLAN mode, which specifies the communication mechanism between multiple MACVLANs on the same lower device\&.
-.RE
-.PP
-\fBtap\fR
-.RS 4
-controls the device type\&. If set to \*(Aqyes\*(Aq a MACVTAP will be created (default:
-no)\&.
-.RE
-.RE
-.PP
-\fBtype vxlan\fR \fBid\fR\ \fIid\fR \fBremote\fR\ \fIaddr\fR [\fBdev\fR\ \fIparent\ device\ (ifname\ or\ connection\ UUID)\fR] [\fBlocal\fR\ \fIaddr\fR] [\fBsource\-port\-min\fR\ \fI0\-65535\fR] [\fBsource\-port\-max\fR\ \fI0\-65535\fR] [\fBdestination\-port\fR\ \fI0\-65535\fR]
-.RS 4
-.PP
-\fBid\fR
-.RS 4
-VXLAN Network Identifer to use\&.
-.RE
-.PP
-\fBremote\fR
-.RS 4
-unicast destination IP address or multicast IP address to join\&.
-.RE
-.PP
-\fBdev\fR
-.RS 4
-device to use for tunnel endpoint communication\&.
-.RE
-.PP
-\fBlocal\fR
-.RS 4
-source IP address\&.
-.RE
-.PP
-\fBsource\-port\-min\fR
-.RS 4
-minimum UDP source port to communicate to the remote VXLAN tunnel endpoint\&.
-.RE
-.PP
-\fBsource\-port\-max\fR
-.RS 4
-maximum UDP source port to communicate to the remote VXLAN tunnel endpoint\&.
-.RE
-.PP
-\fBdestination\-port\fR
-.RS 4
-UDP destination port to communicate to the remote VXLAN tunnel endpoint\&.
-.RE
-.RE
-.PP
-\fBip4\fR, \fBgw4\fR
-.RS 4
-IPv4 addresses\&.
-.RE
-.PP
-\fBip6\fR, \fBgw6\fR
-.RS 4
-IPv6 addresses\&.
-.RE
 .PP
 \fB\-\-\fR
 .RS 4
-If a
+If a single
 \fB\-\-\fR
-argument is encountered, the rest of command line is interpreted as property list in the same format as
-\fBconnection modify\fR
-command accepts\&. This makes it possible to adjust the connection properties before it\*(Aqs added\&.
+argument is encountered it is ignored\&. This is for compatibility with older versions on
+\fBnmcli\fR\&.
 .RE
 .RE
 .PP
-\fBedit\fR {[\fBid\fR\ |\ \fBuuid\fR\ |\ \fBpath\fR]\ \fIID\fR... | [\fBtype\fR\ \fItype\fR]\ [\fBcon\-name\fR\ \fIname\fR] }
+\fBedit\fR {[\fBid\fR\ |\ \fBuuid\fR\ |\ \fBpath\fR]\ \fIID\fR | [\fBtype\fR\ \fItype\fR]\ [\fBcon\-name\fR\ \fIname\fR] }
 .RS 4
 Edit an existing connection or add a new one, using an interactive editor\&.
 .sp
@@ -1228,43 +937,7 @@ for all NetworkManager settings and property names, and their descriptions; and
 for sample editor sessions\&.
 .RE
 .PP
-\fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR...
-.RS 4
-Modify one or more properties in the connection profile\&.
-.sp
-The connection is identified by its name, UUID or D\-Bus path\&. If
-\fIID\fR
-is ambiguous, a keyword
-\fBid\fR,
-\fBuuid\fR
-or
-\fBpath\fR
-can be used\&. See
-\fBnm-settings\fR(5)
-for setting and property names, their descriptions and default values\&. This command supports abbreviations for
-\fIsetting\fR
-and
-\fIproperty\fR
-provided they are unique\&. Empty
-\fIvalue\fR
-("") removes the property value (sets the property to the default value)\&. The provided value overwrites the existing property value\&.
-.sp
-If you want to append an item to the existing value, use
-+
-prefix for the property name\&. If you want to remove just one item from container\-type property, use
-\-
-prefix for the property name and specify a value or an zero\-based index of the item to remove (or option name for properties with named options) as
-\fIvalue\fR\&. Of course,
-+
-and
-\-
-only have a real effect for multi\-value (container) properties like
-ipv4\&.dns,
-ipv4\&.addresses,
-bond\&.options, etc\&.
-.RE
-.PP
-\fBclone\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR... \fBnew\fR\ \fIname\fR
+\fBclone\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR \fInew_name\fR
 .RS 4
 Clone a connection\&. The connection to be cloned is identified by its name, UUID or D\-Bus path\&. If
 \fIID\fR
@@ -1277,8 +950,8 @@ can be used\&. See
 \fBconnection show\fR
 above for the description of the
 \fIID\fR\-specifying keywords\&.
-\fIname\fR
-is the name of the new cloned connection\&. The new connection will be the exact copy except the connection\&.id (\fIname\fR) and connection\&.uuid (generated) properties\&.
+\fInew_name\fR
+is the name of the new cloned connection\&. The new connection will be the exact copy except the connection\&.id (\fInew_name\fR) and connection\&.uuid (generated) properties\&.
 .sp
 The new connection profile will be saved as persistent unless
 \fB\-\-temporary\fR
@@ -1334,7 +1007,7 @@ Reload all connection files from disk\&. NetworkManager does not monitor changes
 Load/reload one or more connection files from disk\&. Use this after manually editing a connection file to ensure that NetworkManager is aware of its latest state\&.
 .RE
 .PP
-\fBimport\fR [\fB\-\-temporary\fR] [\fBtype\fR\ \fItype\fR] [\fBfile\fR\ \fIfile\fR]
+\fBimport\fR [\fB\-\-temporary\fR] \fBtype\fR\ \fItype\fR \fBfile\fR\ \fIfile\fR
 .RS 4
 Import an external/foreign configuration as a NetworkManager connection profile\&. The type of the input file is specified by
 \fBtype\fR
@@ -1366,7 +1039,7 @@ is provided, the VPN configuration data will be printed to standard output\&.
 .RE
 .SH "DEVICE MANAGEMENT COMMANDS"
 .HP \w'\fBnmcli\ device\fR\ 'u
-\fBnmcli device\fR {\fBstatus\fR | \fBshow\fR | \fBset\fR | \fBconnect\fR | \fBreapply\fR | \fBdisconnect\fR | \fBdelete\fR | \fBmonitor\fR | \fBwifi\fR | \fBlldp\fR} [\fIARGUMENTS\fR...]
+\fBnmcli device\fR {\fBstatus\fR | \fBshow\fR | \fBset\fR | \fBconnect\fR | \fBreapply\fR | \fBmodify\fR | \fBdisconnect\fR | \fBdelete\fR | \fBmonitor\fR | \fBwifi\fR | \fBlldp\fR} [\fIARGUMENTS\fR...]
 .PP
 Show and manage network interfaces\&.
 .PP
@@ -1388,7 +1061,7 @@ Show detailed information about devices\&. Without an argument, all devices are
 Set device properties\&.
 .RE
 .PP
-\fBconnect\fR [\fIifname\fR]
+\fBconnect\fR \fIifname\fR
 .RS 4
 Connect the device\&. NetworkManager will try to find a suitable connection that will be activated\&. It will also consider connections that are not set to auto connect\&.
 .sp
@@ -1397,12 +1070,29 @@ If
 option is not specified, the default timeout will be 90 seconds\&.
 .RE
 .PP
-\fBreapply\fR [\fIifname\fR]
+\fBreapply\fR \fIifname\fR
 .RS 4
 Attempt to update device with changes to the currently active connection made since it was last applied\&.
 .RE
 .PP
-\fBdisconnect\fR [\fIifname\fR...]
+\fBmodify\fR \fIifname\fR {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
+.RS 4
+Modify the settings currently active on the device\&.
+.sp
+This command lets you do temporary changes to a configuration active on a particular device\&. The changes are not preserved in the connection profile\&.
+.sp
+See
+\fBnm-settings\fR(5)
+for the list of available properties\&. Please note that some properties can\*(Aqt be changed on an already connected device\&.
+.sp
+You can also use the aliases described in
+PROPERTY ALIASES
+section\&. The syntax is the same as of the
+\fBnmcli connection modify\fR
+command\&.
+.RE
+.PP
+\fBdisconnect\fR \fIifname\fR...
 .RS 4
 Disconnect a device and prevent the device from automatically activating further connections without user/manual intervention\&. Note that disconnecting software devices may mean that the devices will disappear\&.
 .sp
@@ -1411,7 +1101,7 @@ If
 option is not specified, the default timeout will be 10 seconds\&.
 .RE
 .PP
-\fBdelete\fR [\fIifname\fR...]
+\fBdelete\fR \fIifname\fR...
 .RS 4
 Delete a device\&. The command removes the interface from the system\&. Note that this only works for software devices like bonds, bridges, teams, etc\&. Hardware devices (like Ethernet) cannot be deleted by the command\&.
 .sp
@@ -1592,6 +1282,987 @@ Runs
 \fBnmcli\fR
 as both NetworkManager secret and a polkit agent\&.
 .RE
+.SH "PROPERTY ALIASES"
+.PP
+Apart from the property\-value pairs,
+\fBconnection add\fR,
+\fBconnection modify\fR
+and
+\fBdevice modify\fR
+also accept short forms of some properties\&. They exist for convenience and compatiblity with older versions of
+\fBnmcli\fR
+that could not accept the raw properties\&.
+.PP
+The overview of the aliases is below\&. An actual connection type is used to disambiguate these options from the options of the same name that are valid for multiple connection types (such as
+\fBmtu\fR)\&.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&1.\ \&Options for all connections
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Alias
+T}:T{
+Property
+T}:T{
+Note
+T}
+.T&
+l l lt
+l l lt
+l l l
+l l lt
+l l lt
+l l l.
+T{
+type
+T}:T{
+connection.type
+T}:T{
+This option also accepts values of \fBbond\-slave\fR,
+\fBteam\-slave\fR and \fBbridge\-slave\fR\&. They create
+\fBethernet\fR connection profiles\&. Their use is discouraged in
+favor of using a specific type with \fBmaster\fR option\&.
+T}
+T{
+con\-name
+T}:T{
+connection.id
+T}:T{
+When not provided a default name is generated: <type>[\-<ifname>][\-<num>])\&.
+T}
+T{
+autoconnect
+T}:T{
+connection.autoconnect
+T}:T{
+\ \&
+T}
+T{
+ifname
+T}:T{
+connection.interface-name
+T}:T{
+A value of * will be interpreted as
+no value, making the connection profile interface\-independent\&.
+Note: use quotes around * to suppress shell expansion\&.
+For bond, team and bridge connections a default name will be generated if not set\&.
+T}
+T{
+master
+T}:T{
+connection.master
+T}:T{
+Value specified here will be canonicalized\&.
+It can be prefixed with ifname/, uuid/
+or id/ to disambiguate it\&.
+T}
+T{
+slave\-type
+T}:T{
+connection.slave-type
+T}:T{
+\ \&
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&2.\ \&PPPoE options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l.
+T{
+username
+T}:T{
+pppoe.username
+T}
+T{
+password
+T}:T{
+pppoe.password
+T}
+T{
+service
+T}:T{
+pppoe.service
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&3.\ \&Wired Ethernet options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l.
+T{
+mtu
+T}:T{
+wired.mtu
+T}
+T{
+mac
+T}:T{
+wired.mac-address
+T}
+T{
+cloned\-mac
+T}:T{
+wired.cloned-mac-address
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&4.\ \&Infiniband options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l.
+T{
+mtu
+T}:T{
+infiniband.mtu
+T}
+T{
+mac
+T}:T{
+infiniband.mac-address
+T}
+T{
+transport\-mode
+T}:T{
+infiniband.transport-mode
+T}
+T{
+parent
+T}:T{
+infiniband.parent
+T}
+T{
+p\-key
+T}:T{
+infiniband.p-key
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&5.\ \&Wi-Fi options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l.
+T{
+ssid
+T}:T{
+wireless.ssid
+T}
+T{
+mode
+T}:T{
+wireless.mode
+T}
+T{
+mtu
+T}:T{
+wireless.mtu
+T}
+T{
+mac
+T}:T{
+wireless.mac-address
+T}
+T{
+cloned\-mac
+T}:T{
+wireless.cloned-mac-address
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&6.\ \&WiMax options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l.
+T{
+nsp
+T}:T{
+wimax.network-name
+T}
+T{
+mac
+T}:T{
+wimax.mac-address
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&7.\ \&GSM options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l.
+T{
+apn
+T}:T{
+gsm.apn
+T}
+T{
+user
+T}:T{
+gsm.username
+T}
+T{
+password
+T}:T{
+gsm.password
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&8.\ \&CDMA options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l.
+T{
+user
+T}:T{
+cdma.username
+T}
+T{
+password
+T}:T{
+cdma.password
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&9.\ \&Bluetooth options
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Alias
+T}:T{
+Property
+T}:T{
+Note
+T}
+.T&
+l l l
+l l lt.
+T{
+addr
+T}:T{
+bluetooth.bdaddr
+T}:T{
+\ \&
+T}
+T{
+bt\-type
+T}:T{
+bluetooth.type
+T}:T{
+Apart from the usual dun and
+panu options, the values of dun\-gsm
+and dun\-cdma can be used for compatibility with older
+versions\&. They are equivalent to using dun and setting
+appropriate gsm\&.* or cdma\&.* properties\&.
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&10.\ \&VLAN options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l.
+T{
+dev
+T}:T{
+vlan.parent
+T}
+T{
+id
+T}:T{
+vlan.id
+T}
+T{
+flags
+T}:T{
+vlan.flags
+T}
+T{
+ingress
+T}:T{
+vlan.ingress-priority-map
+T}
+T{
+egress
+T}:T{
+vlan.egress-priority-map
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&11.\ \&Bonding options
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Alias
+T}:T{
+Property
+T}:T{
+Note
+T}
+.T&
+l l lt
+l ^ ^
+l ^ ^
+l ^ ^
+l ^ ^
+l ^ ^
+l ^ ^
+l ^ ^.
+T{
+mode
+T}:T{
+bond\&.options
+T}:T{
+Setting each of these adds the option to bond\&.options property\&.
+It\*(Aqs equivalent of using the +bond\&.options \*(Aqoption=value\*(Aq syntax\&.
+T}
+T{
+primary
+T}::
+T{
+miimon
+T}::
+T{
+downdelay
+T}::
+T{
+updelay
+T}::
+T{
+arp\-interval
+T}::
+T{
+arp\-ip\-target
+T}::
+T{
+lacp\-rate
+T}::
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&12.\ \&Team options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l.
+T{
+config
+T}:T{
+team.config
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&13.\ \&Team port options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l.
+T{
+config
+T}:T{
+team-port.config
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&14.\ \&Bridge options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l
+l l.
+T{
+stp
+T}:T{
+bridge.stp
+T}
+T{
+priority
+T}:T{
+bridge.priority
+T}
+T{
+forward\-delay
+T}:T{
+bridge.forward-delay
+T}
+T{
+hello\-time
+T}:T{
+bridge.hello-time
+T}
+T{
+max\-age
+T}:T{
+bridge.max-age
+T}
+T{
+ageing\-time
+T}:T{
+bridge.ageing-time
+T}
+T{
+multicast\-snooping
+T}:T{
+bridge.multicast-snooping
+T}
+T{
+mac
+T}:T{
+bridge.mac-address
+T}
+T{
+priority
+T}:T{
+bridge-port.priority
+T}
+T{
+path\-cost
+T}:T{
+bridge-port.path-cost
+T}
+T{
+hairpin
+T}:T{
+bridge-port.hairpin-mode
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&15.\ \&VPN options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l.
+T{
+vpn\-type
+T}:T{
+vpn.service-type
+T}
+T{
+user
+T}:T{
+vpn.user-name
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&16.\ \&OLPC Mesh options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l.
+T{
+ssid
+T}:T{
+olpc-mesh.ssid
+T}
+T{
+channel
+T}:T{
+olpc-mesh.channel
+T}
+T{
+dhcp\-anycast
+T}:T{
+olpc-mesh.dhcp-anycast-address
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&17.\ \&ADSL options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l.
+T{
+username
+T}:T{
+adsl.username
+T}
+T{
+protocol
+T}:T{
+adsl.protocol
+T}
+T{
+password
+T}:T{
+adsl.password
+T}
+T{
+encapsulation
+T}:T{
+adsl.encapsulation
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&18.\ \&MACVLAN options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l.
+T{
+dev
+T}:T{
+macvlan.parent
+T}
+T{
+mode
+T}:T{
+macvlan.mode
+T}
+T{
+tap
+T}:T{
+macvlan.tap
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&19.\ \&VxLAN options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l
+l l
+l l.
+T{
+id
+T}:T{
+vxlan.id
+T}
+T{
+remote
+T}:T{
+vxlan.remote
+T}
+T{
+dev
+T}:T{
+vxlan.parent
+T}
+T{
+local
+T}:T{
+vxlan.local
+T}
+T{
+source\-port\-min
+T}:T{
+vxlan.source-port-min
+T}
+T{
+source\-port\-max
+T}:T{
+vxlan.source-port-max
+T}
+T{
+destination\-port
+T}:T{
+vxlan.destination-port
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&20.\ \&Tun options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l
+l l
+l l.
+T{
+mode
+T}:T{
+tun.mode
+T}
+T{
+owner
+T}:T{
+tun.owner
+T}
+T{
+group
+T}:T{
+tun.group
+T}
+T{
+pi
+T}:T{
+tun.pi
+T}
+T{
+vnet\-hdr
+T}:T{
+tun.vnet-hdr
+T}
+T{
+multi\-queue
+T}:T{
+tun.multi-queue
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&21.\ \&IP tunneling options
+.TS
+allbox tab(:);
+lB lB.
+T{
+Alias
+T}:T{
+Property
+T}
+.T&
+l l
+l l
+l l
+l l.
+T{
+mode
+T}:T{
+ip-tunnel.mode
+T}
+T{
+local
+T}:T{
+ip-tunnel.local
+T}
+T{
+remote
+T}:T{
+ip-tunnel.remote
+T}
+T{
+dev
+T}:T{
+ip-tunnel.parent
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&22.\ \&IPv4 options
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Alias
+T}:T{
+Property
+T}:T{
+Note
+T}
+.T&
+l l lt
+l l l.
+T{
+ip4
+T}:T{
+ipv4.addresses
+T}:T{
+This option can be specified multiple times\&.
+It\*(Aqs equivalent of using +ipv4\&.addresses syntax\&.
+T}
+T{
+gw4
+T}:T{
+ipv4.gateway
+T}:T{
+\ \&
+T}
+.TE
+.sp 1
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&23.\ \&IPv6 options
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Alias
+T}:T{
+Property
+T}:T{
+Note
+T}
+.T&
+l l lt
+l l l.
+T{
+ip6
+T}:T{
+ipv6.addresses
+T}:T{
+This option can be specified multiple times\&.
+It\*(Aqs equivalent of using +ipv6\&.addresses syntax\&.
+T}
+T{
+gw6
+T}:T{
+ipv6.gateway
+T}:T{
+\ \&
+T}
+.TE
+.sp 1
 .SH "ENVIRONMENT VARIABLES"
 .PP
 \fBnmcli\fR\*(Aqs behavior is affected by the following environment variables\&.
@@ -1692,6 +2363,13 @@ NetworkManager is not running\&.
 .RS 4
 Connection, device, or access point does not exist\&.
 .RE
+.PP
+\fB65\fR
+.RS 4
+When used with
+\fB\-\-complete\-args\fR
+option, a file name is expected to follow\&.
+.RE
 .SH "EXAMPLES"
 .PP
 This section presents various examples of
@@ -1806,6 +2484,16 @@ so that the existing connection profile can be used and no additional is created
 creates a hotspot profile and connects it\&. Prints the hotspot password the user should use to connect to the hotspot from other devices\&.
 .RE
 .PP
+\fBnmcli dev modify em1 ipv4\&.method shared\fR
+.RS 4
+starts IPv4 connection sharing using em1 device\&. The sharing will be active until the device is disconnected\&.
+.RE
+.PP
+\fBnmcli dev modify em1 ipv6\&.address 2001:db8::a:bad:c0de\fR
+.RS 4
+temporarily adds an IP address to a device\&. The address will be removed when the same connection is activated again\&.
+.RE
+.PP
 \fBnmcli connection add type ethernet autoconnect no ifname eth0\fR
 .RS 4
 non\-interactively adds an Ethernet connection tied to eth0 interface with automatic IP configuration (DHCP), and disables the connection\*(Aqs
@@ -1818,7 +2506,7 @@ flag\&.
 non\-interactively adds a VLAN connection with ID 55\&. The connection will use eth0 and the VLAN interface will be named Maxipes\-fik\&.
 .RE
 .PP
-\fBnmcli c a ifname eth0 type ethernet \-\- ipv4\&.method disabled ipv6\&.method link\-local\fR
+\fBnmcli c a ifname eth0 type ethernet ipv4\&.method disabled ipv6\&.method link\-local\fR
 .RS 4
 non\-interactively adds a connection that will use eth0 Ethernet interface and only have an IPv6 link\-local address configured\&.
 .RE