diff options
Diffstat (limited to 'man/nmcli.1')
| -rw-r--r-- | man/nmcli.1 | 48 |
1 files changed, 42 insertions, 6 deletions
diff --git a/man/nmcli.1 b/man/nmcli.1 index 6720403b..4a4661c8 100644 --- a/man/nmcli.1 +++ b/man/nmcli.1 @@ -2,12 +2,12 @@ .\" Title: nmcli .\" Author: .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 08/11/2022 +.\" Date: 08/26/2022 .\" Manual: General Commands Manual -.\" Source: NetworkManager 1.38.4 +.\" Source: NetworkManager 1.40.0 .\" Language: English .\" -.TH "NMCLI" "1" "" "NetworkManager 1\&.38\&.4" "General Commands Manual" +.TH "NMCLI" "1" "" "NetworkManager 1\&.40\&.0" "General Commands Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -220,6 +220,19 @@ will display passwords and secrets that might be present in an output of an oper Output is terse\&. This mode is designed and suitable for computer (script) processing\&. .RE .PP +\fB\-\-offline\fR +.RS 4 +Work without a daemon\&. Makes +\fBconnection add\fR +and +\fBconnection modify\fR +commands accept and produce connection data via standard input/output\&. Ordinarily, nmcli would communicate with the NetworkManager service\&. +.sp +The connection data format (keyfile) is described in +\fBnm-settings-keyfile\fR(5) +manual\&. +.RE +.PP \fB\-v\fR | \fB\-\-version\fR .RS 4 Show @@ -617,7 +630,7 @@ If option is not specified, the default timeout will be 10 seconds\&. .RE .PP -\fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\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 Add, modify or remove properties in the connection profile\&. .sp @@ -654,7 +667,15 @@ is ambiguous, a keyword \fBuuid\fR or \fBpath\fR -can be used\&. +can be used\&. The +\fIID\fR +is not used with the global +\fB\-\-offline\fR +option\&. +.sp +When the global +\fB\-\-offline\fR +is used, the command reads the connection from the standard input and prints the modified connection to standard output instead of making the the NetworkManager daemon act upon specified connection\&. .RE .PP \fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR \fBremove\fR\ \fIsetting\fR @@ -1113,6 +1134,10 @@ If a single argument is encountered it is ignored\&. This is for compatibility with older versions on \fBnmcli\fR\&. .RE +.sp +When the global +\fB\-\-offline\fR +is used, the command prints the resulting connection to standard output instead of actually adding the connection via the NetworkManager daemon\&. .RE .PP \fBedit\fR {[\fBid\fR\ |\ \fBuuid\fR\ |\ \fBpath\fR]\ \fIID\fR | [\fBtype\fR\ \fItype\fR]\ [\fBcon\-name\fR\ \fIname\fR] } @@ -1284,7 +1309,7 @@ option is not specified, the default timeout will be 10 seconds\&. .RE .SH "DEVICE MANAGEMENT COMMANDS" .HP \w'\fBnmcli\ device\fR\ 'u -\fBnmcli device\fR {\fBstatus\fR | \fBshow\fR | \fBset\fR | \fBup\fR | \fBconnect\fR | \fBreapply\fR | \fBmodify\fR | \fBdown\fR | \fBdisconnect\fR | \fBdelete\fR | \fBmonitor\fR | \fBwifi\fR | \fBlldp\fR} [\fIARGUMENTS\fR...] +\fBnmcli device\fR {\fBstatus\fR | \fBshow\fR | \fBset\fR | \fBup\fR | \fBconnect\fR | \fBreapply\fR | \fBmodify\fR | \fBdown\fR | \fBdisconnect\fR | \fBdelete\fR | \fBmonitor\fR | \fBwifi\fR | \fBlldp\fR | \fBcheckpoint\fR} [\fIARGUMENTS\fR...] .PP Show and manage network interfaces\&. .PP @@ -1518,6 +1543,17 @@ Display information about neighboring devices learned through the Link Layer Dis \fBifname\fR option can be used to list neighbors only for a given interface\&. The protocol must be enabled in the connection settings\&. .RE +.PP +\fBcheckpoint\fR [\fB\-\-timeout\fR\ \fIseconds\fR] [\fIifname\fR...] \fB\-\-\fR \fICOMMAND\fR... +.RS 4 +Runs the command with a configuration checkpoint taken and asks for a confirmation when finished\&. When the confirmation is not given, the checkpoint is automatically restored after timeout\&. +.sp +This allows doing disruptive configuration changes over remote connections with an option of restoring the network configuration to a known good state in case of an error\&. +.sp +If the a list of interface names is specified, the checkpoint is taken, the checkpoint is takes only on the specified devices\&. Otherwise a checkpoint is taken for all devices\&. +.sp +Currently the timeout defaults to 15 seconds\&. This may change in a future version\&. +.RE .SH "SECRET AGENT" .HP \w'\fBnmcli\ agent\fR\ 'u \fBnmcli agent\fR {\fBsecret\fR | \fBpolkit\fR | \fBall\fR} |