From a54ac63bbf9b2c71026ac9028a8ffaf186cf3c82 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Sun, 28 Jun 2020 18:58:14 +0200 Subject: New upstream version 1.25.90 --- man/nm-settings-nmcli.xsl | 168 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 168 insertions(+) create mode 100644 man/nm-settings-nmcli.xsl (limited to 'man/nm-settings-nmcli.xsl') diff --git a/man/nm-settings-nmcli.xsl b/man/nm-settings-nmcli.xsl new file mode 100644 index 00000000..a31922a5 --- /dev/null +++ b/man/nm-settings-nmcli.xsl @@ -0,0 +1,168 @@ + + +%entities; +]> + + + + + + + + nm-settings-nmcli + NetworkManager developers + + + nm-settings-nmcli + 5 + NetworkManager + Configuration + &NM_VERSION; + + + nm-settings-nmcli + Description of settings and properties of NetworkManager connection profiles for nmcli + + + Description + + NetworkManager is based on a concept of connection profiles, sometimes referred to as + connections only. These connection profiles contain a network configuration. When + 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. + + + 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. + + + The setting and + property can be abbreviated provided they are unique. The list below + also shows aliases that can be used unqualified instead of the full name. For example + connection.interface-name and ifname refer to the same + property. + + + + Secret flag types: + + Each password or secret property in a setting has an associated flags property + that describes how to handle that secret. The flags property is a bitfield + that contains zero or more of the following values logically OR-ed together. + + + + 0x0 (none) - the system is responsible for providing and storing this secret. This + may be required so that secrets are already available before the user logs in. + It also commonly means that the secret will be stored in plain text on disk, accessible + to root only. For example via the keyfile settings plugin as described in the "PLUGINS" section + in NetworkManager.conf5. + + + + 0x1 (agent-owned) - a user-session secret agent is responsible for providing and storing + this secret; when it is required, agents will be asked to provide it. + + + 0x2 (not-saved) - this secret should not be saved but should be requested from the user + each time it is required. This flag should be used for One-Time-Pad secrets, PIN codes from hardware tokens, + or if the user simply does not want to save the secret. + + + 0x4 (not-required) - in some situations it cannot be automatically determined that a secret + is required or not. This flag hints that the secret is not required and should not be requested from the user. + + + + + + Files + /etc/NetworkManager/system-connections or distro plugin-specific location + + + See Also + + nmcli1, + nmcli-examples7, + NetworkManager8, + nm-settings-dbus5, + nm-settings-keyfile5, + NetworkManager.conf5 + + + + + + + <xsl:value-of select="@name"/> setting + + + Alias: + + + . + + Properties: + + + + + + + + + + + + + + + + + Alias: + + + + + + See for flag values. + + + + + Format: + + + + + + + -- cgit 1.3.0-6-gf8a5