From 09f484ae9fec482f8db39771717acf0514b0274a Mon Sep 17 00:00:00 2001 From: Thomas Haller Date: Thu, 4 Jun 2020 16:41:43 +0200 Subject: [PATCH] docs: update documentation for nm-settings-nmcli manual --- man/nm-settings-dbus.xsl | 10 ++++-- man/nm-settings-nmcli.xsl | 74 ++++++++++++++------------------------- 2 files changed, 34 insertions(+), 50 deletions(-) diff --git a/man/nm-settings-dbus.xsl b/man/nm-settings-dbus.xsl index 0573d0d3b8..b4841ce200 100644 --- a/man/nm-settings-dbus.xsl +++ b/man/nm-settings-dbus.xsl @@ -27,7 +27,7 @@ nm-settings-dbus - Description of settings and properties of NetworkManager connection profiles + Description of settings and properties of NetworkManager connection profiles on the D-Bus API Description @@ -122,10 +122,14 @@ See Also - NetworkManager8, + + nm-settings-nmcli5, + nm-settings-keyfile5, + NetworkManager8, nmcli1, nmcli-examples7, - NetworkManager.conf5 + NetworkManager.conf5 + diff --git a/man/nm-settings-nmcli.xsl b/man/nm-settings-nmcli.xsl index 28e7504931..a1dd94b6e0 100644 --- a/man/nm-settings-nmcli.xsl +++ b/man/nm-settings-nmcli.xsl @@ -27,7 +27,7 @@ nm-settings-nmcli - Description of settings and properties of NetworkManager connection profiles + Description of settings and properties of NetworkManager connection profiles for nmcli Description @@ -37,51 +37,28 @@ NetworkManager activates a connection profile on a network device the configuration will be applied and an active network connection will be established. Users are free to create as many connection profiles as they see fit. Thus they are flexible in having various network - configurations for different networking needs. The connection profiles are handled by - NetworkManager via settings service and are exported on D-Bus - (/org/freedesktop/NetworkManager/Settings/<num> objects). - The conceptual objects can be described as follows: - - - Connection (profile) - - - A specific, encapsulated, independent group of settings describing - all the configuration required to connect to a specific network. - It is referred to by a unique identifier called the UUID. A connection - is tied to a one specific device type, but not necessarily a specific - hardware device. It is composed of one or more Settings - objects. - - - - - - - Setting - - - A group of related key/value pairs describing a specific piece of a - Connection (profile). Settings keys and allowed values are - described in the tables below. Keys are also referred to as properties. - Developers can find the setting objects and their properties in the libnm-core - sources. Look for the *_class_init functions near the bottom - of each setting source file. - - - - - - - The settings and properties shown in tables below list all available connection - configuration options. However, note that not all settings are applicable to all - connection types. NetworkManager provides a command-line tool nmcli - that allows direct configuration of the settings and properties according to a connection - profile type. nmcli connection editor has also a built-in - describe command that can display description of particular settings - and properties of this page. - - + configurations for different networking needs. + + + NetworkManager provides an API for configuring connection profiles, for activating them + to configure the network, and inspecting the current network configuration. The command + line tool nmcli is a client application to NetworkManager that uses + this API. See nmcli1 + for details. + + + With commands like nmcli connection add, nmcli connection modify + and nmcli connection show, connection profiles can be created, modified + and inspected. A profile consists of properties. On D-Bus this follows the format + as described by nm-settings-dbus5, + while this manual page describes the settings format how they are expected by nmcli. + + + The settings and properties shown in tables below list all available connection + configuration options. However, note that not all settings are applicable to all + connection types. nmcli connection editor has also a built-in + describe command that can display description of particular settings + and properties of this page. @@ -122,7 +99,10 @@ See Also - NetworkManager8, + + nm-settings-dbus5, + nm-settings-keyfile5, + NetworkManager8, nmcli1, nmcli-examples7, NetworkManager.conf5