diff options
Diffstat (limited to 'man/nmcli-examples.5')
| -rw-r--r-- | man/nmcli-examples.5 | 676 |
1 files changed, 676 insertions, 0 deletions
diff --git a/man/nmcli-examples.5 b/man/nmcli-examples.5 new file mode 100644 index 000000000..7145d682c --- /dev/null +++ b/man/nmcli-examples.5 @@ -0,0 +1,676 @@ +'\" 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) |