diff options
Diffstat (limited to 'man/nm-settings-keyfile.xml')
| -rw-r--r-- | man/nm-settings-keyfile.xml | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/man/nm-settings-keyfile.xml b/man/nm-settings-keyfile.xml index ed84e458..aa62837e 100644 --- a/man/nm-settings-keyfile.xml +++ b/man/nm-settings-keyfile.xml @@ -1,18 +1,20 @@ <?xml version="1.0"?> <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"> -<refentry id="nm-settings-keyfile"><refentryinfo><title>nm-settings-keyfile</title><author>NetworkManager developers</author></refentryinfo><refmeta><refentrytitle>nm-settings-keyfile</refentrytitle><manvolnum>5</manvolnum><refmiscinfo class="source">NetworkManager</refmiscinfo><refmiscinfo class="manual">Configuration</refmiscinfo><refmiscinfo class="version">1.22.10</refmiscinfo></refmeta><refnamediv><refname>nm-settings-keyfile</refname><refpurpose>Description of <emphasis>keyfile</emphasis> settings plugin</refpurpose></refnamediv><refsect1 id="description"><title>Description</title><para> +<refentry id="nm-settings-keyfile"><refentryinfo><title>nm-settings-keyfile</title><author>NetworkManager developers</author></refentryinfo><refmeta><refentrytitle>nm-settings-keyfile</refentrytitle><manvolnum>5</manvolnum><refmiscinfo class="source">NetworkManager</refmiscinfo><refmiscinfo class="manual">Configuration</refmiscinfo><refmiscinfo class="version">1.23.90</refmiscinfo></refmeta><refnamediv><refname>nm-settings-keyfile</refname><refpurpose>Description of <emphasis>keyfile</emphasis> settings plugin</refpurpose></refnamediv><refsect1 id="description"><title>Description</title><para> NetworkManager is based on the concept of connection profiles that contain network configuration (see <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details). The profiles can be stored in various formats. NetworkManager uses plugins for reading and writing the data. The plugins can be configured in <citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>. </para><para> The <emphasis>keyfile</emphasis> plugin is the generic plugin that supports all - the connection types and capabilities that NetworkManager has. It writes files - out in a .ini-style format in <filename>/etc/NetworkManager/system-connections/</filename>. + the connection types and capabilities that NetworkManager has. The files are + in a .ini-style format and located in <filename>/etc/NetworkManager/system-connections/</filename>, + <filename>/usr/lib/NetworkManager/system-connections/</filename> and + <filename>/run/NetworkManager/system-connections/</filename>. This plugin is always enabled and will automatically be used to store any connections that are not supported by any other active plugin. For security, it will ignore files that are readable or writable by any user - or group other than 'root' since private keys and passphrases may be stored + other than 'root' since private keys and passphrases may be stored in plaintext inside the file. </para></refsect1><refsect1 id="file_format"><title>File Format</title><para> The <emphasis>keyfile</emphasis> config format is a simple .ini-style @@ -34,8 +36,7 @@ Users can create or modify the <emphasis>keyfile</emphasis> connection files manually, even if that is not the recommended way of managing the profiles. However, if they choose to do that, they must inform NetworkManager about - their changes (see <emphasis>monitor-connection-file</emphasis> in - <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry> and <emphasis>nmcli con (re)load</emphasis>). + their changes (for example via <emphasis>nmcli con (re)load</emphasis>). </para><formalpara><title>Examples of <emphasis>keyfile</emphasis> configuration</title><para><programlisting><emphasis role="bold">A sample configuration for an ethernet network:</emphasis> [connection] id=Main eth0 @@ -219,6 +220,7 @@ Example: </emphasis>remote=ovpn.corp.com cipher=AES-256-CBC username=joe</entry> Example: </emphasis>password=Popocatepetl</entry></row> </tbody></tgroup></table> + <table><title>wifi-p2p setting (section)</title><tgroup cols="4"><thead><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row></thead><tbody> <row><entry align="left">peer</entry><entry align="left">peer</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">MAC address in traditional hex-digits-and-colons notation (e.g. 00:22:68:12:79:A2), or semicolon separated list of 6 bytes (obsolete) (e.g. 0;34;104;18;121;162).</entry></row> </tbody></tgroup></table> |