From 67b83998c32780822266d90aa35eea5953777b6b Mon Sep 17 00:00:00 2001 From: Managor <42655600+Managor@users.noreply.github.com> Date: Sun, 20 Jul 2025 01:37:29 +0300 Subject: [PATCH] nmcli*: refresh pages (#17258) --- pages/linux/nmcli-agent.md | 7 +++---- pages/linux/nmcli-connection.md | 15 +++++++-------- pages/linux/nmcli-device.md | 9 ++++----- pages/linux/nmcli-general.md | 13 ++++++------- pages/linux/nmcli-monitor.md | 3 +-- pages/linux/nmcli-networking.md | 9 ++++----- pages/linux/nmcli-radio.md | 13 ++++++------- pages/linux/nmcli.md | 8 ++++---- 8 files changed, 35 insertions(+), 42 deletions(-) diff --git a/pages/linux/nmcli-agent.md b/pages/linux/nmcli-agent.md index 1d4ce22557..b1639a14e8 100644 --- a/pages/linux/nmcli-agent.md +++ b/pages/linux/nmcli-agent.md @@ -1,17 +1,16 @@ # nmcli agent > Run `nmcli` as a NetworkManager secret agent or polkit agent. -> This subcommand can also be called with `nmcli a`. > More information: . - Register `nmcli` as a secret agent and listen for secret requests: -`nmcli agent secret` +`nmcli {{[a|agent]}} {{[s|secret]}}` - Register `nmcli` as a polkit agent and listen for authorization requests: -`nmcli agent polkit` +`nmcli {{[a|agent]}} {{[p|polkit]}}` - Register `nmcli` as a secret agent and a polkit agent: -`nmcli agent all` +`nmcli {{[a|agent]}} {{[a|all]}}` diff --git a/pages/linux/nmcli-connection.md b/pages/linux/nmcli-connection.md index 3f29b30e32..1712ef466b 100644 --- a/pages/linux/nmcli-connection.md +++ b/pages/linux/nmcli-connection.md @@ -1,33 +1,32 @@ # nmcli connection > Manage connections with NetworkManager. -> This subcommand can also be called with `nmcli c`. > More information: . - List all NetworkManager connections (shows name, UUID, type and device): -`nmcli connection` +`nmcli {{[c|connection]}}` - Activate a connection: -`nmcli connection up uuid {{uuid}}` +`nmcli {{[c|connection]}} {{[u|up]}} {{uuid}}` - Deactivate a connection: -`nmcli connection down uuid {{uuid}}` +`nmcli {{[c|connection]}} {{[d|down]}} {{uuid}}` - Create an auto-configured dual stack connection: -`nmcli connection add ifname {{interface_name}} type {{ethernet}} ipv4.method {{auto}} ipv6.method {{auto}}` +`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ipv4.method {{auto}} ipv6.method {{auto}}` - Create a static IPv6-only connection: -`nmcli connection add ifname {{interface_name}} type {{ethernet}} ip6 {{2001:db8::2/64}} gw6 {{2001:db8::1}} ipv6.dns {{2001:db8::1}} ipv4.method {{ignore}}` +`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ip6 {{2001:db8::2/64}} gw6 {{2001:db8::1}} ipv6.dns {{2001:db8::1}} ipv4.method {{ignore}}` - Create a static IPv4-only connection: -`nmcli connection add ifname {{interface_name}} type {{ethernet}} ip4 {{10.0.0.7/8}} gw4 {{10.0.0.1}} ipv4.dns {{10.0.0.1}} ipv6.method {{ignore}}` +`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ip4 {{10.0.0.7/8}} gw4 {{10.0.0.1}} ipv4.dns {{10.0.0.1}} ipv6.method {{ignore}}` - Create a VPN connection using OpenVPN from an OVPN file: -`nmcli connection import type {{openvpn}} file {{path/to/vpn_config.ovpn}}` +`nmcli {{[c|connection]}} {{[i|import]}} type {{openvpn}} file {{path/to/vpn_config.ovpn}}` diff --git a/pages/linux/nmcli-device.md b/pages/linux/nmcli-device.md index d93dae3ef5..88714894e7 100644 --- a/pages/linux/nmcli-device.md +++ b/pages/linux/nmcli-device.md @@ -1,21 +1,20 @@ # nmcli device > Manage network interfaces and establish new Wi-Fi connections using NetworkManager. -> This subcommand can also be called with `nmcli d`. > More information: . - Print the statuses of all network interfaces: -`nmcli device status` +`nmcli {{[d|device]}}` - Print the available Wi-Fi access points: -`nmcli device wifi` +`nmcli {{[d|device]}} {{[w|wifi]}}` - Connect to a Wi-Fi network with the specified SSID (you will be prompted for a password): -`nmcli --ask device wifi connect {{ssid}}` +`nmcli {{[d|device]}} {{[w|wifi]}} {{[c|connect]}} {{ssid}} {{[-a|--ask]}}` - Print the password and QR code for the current Wi-Fi network: -`nmcli device wifi show-password` +`nmcli {{[d|device]}} {{[w|wifi]}} {{[s|show-password]}}` diff --git a/pages/linux/nmcli-general.md b/pages/linux/nmcli-general.md index 50c7be9a33..a236e1c4c8 100644 --- a/pages/linux/nmcli-general.md +++ b/pages/linux/nmcli-general.md @@ -1,29 +1,28 @@ # nmcli general > Manage general settings of NetworkManager. -> This subcommand can also be called with `nmcli g`. > More information: . - Show the general status of NetworkManager: -`nmcli general` +`nmcli {{[g|general]}}` - Show the hostname of the current device: -`nmcli general hostname` +`nmcli {{[g|general]}} {{[h|hostname]}}` - Change the hostname of the current device: -`sudo nmcli general hostname {{new_hostname}}` +`sudo nmcli {{[g|general]}} {{[h|hostname]}} {{new_hostname}}` - Show the permissions of NetworkManager: -`nmcli general permissions` +`nmcli {{[g|general]}} {{[p|permissions]}}` - Show the current logging level and domains: -`nmcli general logging` +`nmcli {{[g|general]}} {{[l|logging]}}` - Set the logging level and/or domains (see `man NetworkManager.conf` for all available domains): -`nmcli general logging level {{INFO|OFF|ERR|WARN|DEBUG|TRACE}} domain {{domain_1,domain_2,...}}` +`sudo nmcli {{[g|general]}} {{[l|logging]}} {{[l|level]}} {{INFO|OFF|ERR|WARN|DEBUG|TRACE}} domain {{domain_1,domain_2,...}}` diff --git a/pages/linux/nmcli-monitor.md b/pages/linux/nmcli-monitor.md index 8ce5321ee6..5280acdfe8 100644 --- a/pages/linux/nmcli-monitor.md +++ b/pages/linux/nmcli-monitor.md @@ -1,9 +1,8 @@ # nmcli monitor > Monitor changes to the NetworkManager connection status. -> This subcommand can also be called with `nmcli m`. > More information: . - Start monitoring NetworkManager changes: -`nmcli monitor` +`nmcli {{[m|monitor]}}` diff --git a/pages/linux/nmcli-networking.md b/pages/linux/nmcli-networking.md index 5e0bcddf77..e881f4943b 100644 --- a/pages/linux/nmcli-networking.md +++ b/pages/linux/nmcli-networking.md @@ -1,21 +1,20 @@ # nmcli networking > Manage the networking status of NetworkManager. -> This subcommand can also be called with `nmcli n`. > More information: . - Show the networking status of NetworkManager: -`nmcli networking` +`nmcli {{[n|networking]}}` - Enable or disable networking and all interfaces managed by NetworkManager: -`nmcli networking {{on|off}}` +`nmcli {{[n|networking]}} {{on|off}}` - Show the last known connectivity state: -`nmcli networking connectivity` +`nmcli {{[n|networking]}} {{[c|connectivity]}}` - Show the current connectivity state: -`nmcli networking connectivity check` +`nmcli {{[n|networking]}} {{[c|connectivity]}} {{[c|check]}}` diff --git a/pages/linux/nmcli-radio.md b/pages/linux/nmcli-radio.md index 7cdd3c5e85..64da99985e 100644 --- a/pages/linux/nmcli-radio.md +++ b/pages/linux/nmcli-radio.md @@ -1,29 +1,28 @@ # nmcli radio > Show the status of radio switches or enable/disable them using NetworkManager. -> This subcommand can also be called with `nmcli r`. > More information: . - Show status of Wi-Fi: -`nmcli radio wifi` +`nmcli {{[r|radio]}} {{[w|wifi]}}` - Turn Wi-Fi on or off: -`nmcli radio wifi {{on|off}}` +`nmcli {{[r|radio]}} {{[w|wifi]}} {{on|off}}` - Show status of WWAN: -`nmcli radio wwan` +`nmcli {{[r|radio]}} {{[ww|wwan]}}` - Turn WWAN on or off: -`nmcli radio wwan {{on|off}}` +`nmcli {{[r|radio]}} {{[ww|wwan]}} {{on|off}}` - Show status of both switches: -`nmcli radio all` +`nmcli {{[r|radio]}}` - Turn both switches on or off: -`nmcli radio all {{on|off}}` +`nmcli {{[r|radio]}} {{[a|all]}} {{on|off}}` diff --git a/pages/linux/nmcli.md b/pages/linux/nmcli.md index 6fe1c2434f..f65f3414da 100644 --- a/pages/linux/nmcli.md +++ b/pages/linux/nmcli.md @@ -3,17 +3,17 @@ > Manage the network configuration using NetworkManager. > More information: . -- View documentation for running `nmcli` as a NetworkManager secret/polkit agent: +- View documentation for managing network interfaces and establishing new Wi-Fi connections: -`tldr nmcli agent` +`tldr nmcli device` - View documentation for managing network connections: `tldr nmcli connection` -- View documentation for managing network interfaces and establishing new Wi-Fi connections: +- View documentation for running `nmcli` as a NetworkManager secret/polkit agent: -`tldr nmcli device` +`tldr nmcli agent` - View documentation for managing general settings of NetworkManager: