|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<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.26.0</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>
|
|
Packit Service |
b23acc |
NetworkManager is based on the concept of connection profiles that contain
|
|
Packit Service |
b23acc |
network configuration (see <citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details). The profiles can be
|
|
Packit Service |
b23acc |
stored in various formats. NetworkManager uses plugins for reading and writing
|
|
Packit Service |
b23acc |
the data. The plugins can be configured in <citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
|
Packit Service |
b23acc |
</para><para>
|
|
Packit Service |
b23acc |
The <emphasis>keyfile</emphasis> plugin is the generic plugin that supports all
|
|
Packit Service |
b23acc |
the connection types and capabilities that NetworkManager has. The files are
|
|
Packit Service |
b23acc |
in a .ini-style format and located in <filename>/etc/NetworkManager/system-connections/</filename>,
|
|
Packit Service |
b23acc |
<filename>/usr/lib/NetworkManager/system-connections/</filename> and
|
|
Packit Service |
b23acc |
<filename>/run/NetworkManager/system-connections/</filename>.
|
|
Packit Service |
b23acc |
This plugin is always enabled and will automatically be used to store
|
|
Packit Service |
b23acc |
any connections that are not supported by any other active plugin.
|
|
Packit Service |
b23acc |
For security, it will ignore files that are readable or writable by any user
|
|
Packit Service |
b23acc |
other than 'root' since private keys and passphrases may be stored
|
|
Packit Service |
b23acc |
in plaintext inside the file.
|
|
Packit Service |
b23acc |
</para></refsect1><refsect1 id="file_format"><title>File Format</title><para>
|
|
Packit Service |
b23acc |
The <emphasis>keyfile</emphasis> config format is a simple .ini-style
|
|
Packit Service |
b23acc |
format. It consists of sections (groups) of key-value pairs. Each section
|
|
Packit Service |
b23acc |
corresponds to a setting name as described in the settings specification
|
|
Packit Service |
b23acc |
(<citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry>). Each configuration key/value
|
|
Packit Service |
b23acc |
pair in the section is one of the properties listed in the settings
|
|
Packit Service |
b23acc |
specification. The majority of properties of the specification is written
|
|
Packit Service |
b23acc |
in the same format into the <emphasis>keyfile</emphasis> too. However
|
|
Packit Service |
b23acc |
some values are inconvenient for people to use. These are stored in the
|
|
Packit Service |
b23acc |
files in more readable ways. These properties are described below.
|
|
Packit Service |
b23acc |
An example could be IP addresses that are not written as integer arrays,
|
|
Packit Service |
b23acc |
but more reasonably as "1.2.3.4/12 1.2.3.254".
|
|
Packit Service |
b23acc |
More information of the generic key file format can be found at
|
|
Packit Service |
b23acc |
<ulink url="https://developer.gnome.org/glib/stable/glib-Key-value-file-parser.html#glib-Key-value-file-parser.description">
|
|
Packit Service |
b23acc |
GLib key file format</ulink> (Lines beginning with a '#' are comments,
|
|
Packit Service |
b23acc |
lists are separated by character <literal>;</literal> etc.).
|
|
Packit Service |
b23acc |
</para><para>
|
|
Packit Service |
b23acc |
Users can create or modify the <emphasis>keyfile</emphasis> connection files
|
|
Packit Service |
b23acc |
manually, even if that is not the recommended way of managing the profiles.
|
|
Packit Service |
b23acc |
However, if they choose to do that, they must inform NetworkManager about
|
|
Packit Service |
b23acc |
their changes (for example via <emphasis>nmcli con (re)load</emphasis>).
|
|
Packit Service |
b23acc |
</para><formalpara><title>Examples of <emphasis>keyfile</emphasis> configuration</title><para><programlisting><emphasis role="bold">A sample configuration for an ethernet network:</emphasis>
|
|
Packit Service |
b23acc |
[connection]
|
|
Packit Service |
b23acc |
id=Main eth0
|
|
Packit Service |
b23acc |
uuid=27afa607-ee36-43f0-b8c3-9d245cdc4bb3
|
|
Packit Service |
b23acc |
type=802-3-ethernet
|
|
Packit Service |
b23acc |
autoconnect=true
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[ipv4]
|
|
Packit Service |
b23acc |
method=auto
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[802-3-ethernet]
|
|
Packit Service |
b23acc |
mac-address=00:23:5a:47:1f:71
|
|
Packit Service |
b23acc |
</programlisting></para><para><programlisting><emphasis role="bold">A sample configuration for WPA-EAP (PEAP with MSCHAPv2) and always-ask secret:</emphasis>
|
|
Packit Service |
b23acc |
[connection]
|
|
Packit Service |
b23acc |
id=CompanyWIFI
|
|
Packit Service |
b23acc |
uuid=cdac6154-a33b-4b15-9904-666772cfa5ee
|
|
Packit Service |
b23acc |
type=wifi
|
|
Packit Service |
b23acc |
autoconnect=false
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[wifi]
|
|
Packit Service |
b23acc |
ssid=CorpWLAN
|
|
Packit Service |
b23acc |
mode=infrastructure
|
|
Packit Service |
b23acc |
security=802-11-wireless-security
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[wifi-security]
|
|
Packit Service |
b23acc |
key-mgmt=wpa-eap
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[ipv4]
|
|
Packit Service |
b23acc |
method=auto
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[ipv6]
|
|
Packit Service |
b23acc |
method=auto
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[802-1x]
|
|
Packit Service |
b23acc |
eap=peap;
|
|
Packit Service |
b23acc |
identity=joe
|
|
Packit Service |
b23acc |
ca-cert=/home/joe/.cert/corp.crt
|
|
Packit Service |
b23acc |
phase1-peapver=1
|
|
Packit Service |
b23acc |
phase2-auth=mschapv2
|
|
Packit Service |
b23acc |
password-flags=2
|
|
Packit Service |
b23acc |
</programlisting></para><para><programlisting><emphasis role="bold">A sample configuration for openvpn:</emphasis>
|
|
Packit Service |
b23acc |
[connection]
|
|
Packit Service |
b23acc |
id=RedHat-openvpn
|
|
Packit Service |
b23acc |
uuid=7f9b3356-b210-4c0e-8123-bd116c9c280f
|
|
Packit Service |
b23acc |
type=vpn
|
|
Packit Service |
b23acc |
timestamp=1385401165
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[vpn]
|
|
Packit Service |
b23acc |
service-type=org.freedesktop.NetworkManager.openvpn
|
|
Packit Service |
b23acc |
connection-type=password
|
|
Packit Service |
b23acc |
password-flags=3
|
|
Packit Service |
b23acc |
remote=ovpn.my-company.com
|
|
Packit Service |
b23acc |
cipher=AES-256-CBC
|
|
Packit Service |
b23acc |
reneg-seconds=0
|
|
Packit Service |
b23acc |
port=443
|
|
Packit Service |
b23acc |
username=joe
|
|
Packit Service |
b23acc |
ca=/etc/openvpn/ISCA.pem
|
|
Packit Service |
b23acc |
tls-remote=ovpn.my-company.com
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[ipv6]
|
|
Packit Service |
b23acc |
method=auto
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[ipv4]
|
|
Packit Service |
b23acc |
method=auto
|
|
Packit Service |
b23acc |
ignore-auto-dns=true
|
|
Packit Service |
b23acc |
never-default=true
|
|
Packit Service |
b23acc |
</programlisting></para><para><programlisting><emphasis role="bold">A sample configuration for a bridge and a bridge port:</emphasis>
|
|
Packit Service |
b23acc |
[connection] [connection]
|
|
Packit Service |
b23acc |
id=MainBridge id=br-port-1
|
|
Packit Service |
b23acc |
uuid=171ae855-a0ab-42b6-bd0c-60f5812eea9d uuid=d6e8ae98-71f8-4b3d-9d2d-2e26048fe794
|
|
Packit Service |
b23acc |
interface-name=MainBridge interface-name=em1
|
|
Packit Service |
b23acc |
type=bridge type=ethernet
|
|
Packit Service |
b23acc |
master=MainBridge
|
|
Packit Service |
b23acc |
[bridge] slave-type=bridge
|
|
Packit Service |
b23acc |
interface-name=MainBridge
|
|
Packit Service |
b23acc |
</programlisting></para><para><programlisting><emphasis role="bold">A sample configuration for a VLAN:</emphasis>
|
|
Packit Service |
b23acc |
[connection]
|
|
Packit Service |
b23acc |
id=VLAN for building 4A
|
|
Packit Service |
b23acc |
uuid=8ce1c9e0-ce7a-4d2c-aa28-077dda09dd7e
|
|
Packit Service |
b23acc |
interface-name=VLAN-4A
|
|
Packit Service |
b23acc |
type=vlan
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
[vlan]
|
|
Packit Service |
b23acc |
interface-name=VLAN-4A
|
|
Packit Service |
b23acc |
parent=eth0
|
|
Packit Service |
b23acc |
id=4
|
|
Packit Service |
b23acc |
</programlisting></para></formalpara></refsect1><refsect1 id="details"><title>Details</title><para><emphasis>keyfile</emphasis> plugin variables for the majority of NetworkManager
|
|
Packit Service |
b23acc |
properties have one-to-one mapping. It means a NetworkManager property is stored
|
|
Packit Service |
b23acc |
in the keyfile as a variable of the same name and in the same format.
|
|
Packit Service |
b23acc |
There are several exceptions to this rule, mainly for making keyfile syntax easier
|
|
Packit Service |
b23acc |
for humans. The exceptions handled specially by <emphasis>keyfile</emphasis>
|
|
Packit Service |
b23acc |
plugin are listed below. Refer to
|
|
Packit Service |
b23acc |
<link linkend="nm-settings"><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>
|
|
Packit Service |
b23acc |
for all available settings and properties and their description.
|
|
Packit Service |
b23acc |
</para><formalpara><title>Name aliases</title><para>
|
|
Packit Service |
b23acc |
Some of the NetworkManager setting names are somewhat hard to type or remember. Therefore
|
|
Packit Service |
b23acc |
<emphasis>keyfile</emphasis> introduces aliases that can be used instead of the names.
|
|
Packit Service |
b23acc |
<simplelist type="horiz" columns="1"><member><emphasis>setting name keyfile alias</emphasis></member><member>802-3-ethernet = ethernet</member><member>802-11-wireless = wifi</member><member>802-11-wireless-security = wifi-security</member></simplelist></para></formalpara>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>bridge setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address</entry><entry align="left">mac-address</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">MAC address in traditional hex-digits-and-colons notation, or semicolon separated list of 6 decimal bytes (obsolete)<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>mac-address=00:22:68:12:79:A2 mac-address=0;34;104;18;121;162;</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>infiniband setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address</entry><entry align="left">mac-address</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">MAC address in traditional hex-digits-and-colons notation, or or semicolon separated list of 20 decimal bytes (obsolete)<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>mac-address= 80:00:00:6d:fe:80:00:00:00:00:00:00:00:02:55:00:70:33:cf:01</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>ipv4 setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">dns</entry><entry align="left">dns</entry><entry align="left">list of DNS IP addresses</entry><entry align="left">List of DNS servers.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>dns=1.2.3.4;8.8.8.8;8.8.4.4;</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">addresses</entry><entry align="left">address1, address2, ...</entry><entry align="left">address/plen</entry><entry align="left">List of static IP addresses.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>address1=192.168.100.100/24 address2=10.1.1.5/24</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">gateway</entry><entry align="left">gateway</entry><entry align="left">string</entry><entry align="left">Gateway IP addresses as a string.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>gateway=192.168.100.1</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">routes</entry><entry align="left">route1, route2, ...</entry><entry align="left">route/plen[,gateway,metric]</entry><entry align="left">List of IP routes.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>route1=8.8.8.0/24,10.1.1.1,77 route2=7.7.0.0/16</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
<title>ipv6 setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">dns</entry><entry align="left">dns</entry><entry align="left">list of DNS IP addresses</entry><entry align="left">List of DNS servers.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>dns=2001:4860:4860::8888;2001:4860:4860::8844;</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">addresses</entry><entry align="left">address1, address2, ...</entry><entry align="left">address/plen</entry><entry align="left">List of static IP addresses.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>address1=abbe::cafe/96 address2=2001::1234</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">gateway</entry><entry align="left">gateway</entry><entry align="left">string</entry><entry align="left">Gateway IP addresses as a string.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>gateway=abbe::1</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">routes</entry><entry align="left">route1, route2, ...</entry><entry align="left">route/plen[,gateway,metric]</entry><entry align="left">List of IP routes.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>route1=2001:4860:4860::/64,2620:52:0:2219:222:68ff:fe11:5403</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>serial setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">parity</entry><entry align="left">parity</entry><entry align="left">'e', 'o', or 'n'</entry><entry align="left">The connection parity; even, odd, or none. Note that older versions of NetworkManager stored this as an integer: 69 ('E') for even, 111 ('o') for odd, or 110 ('n') for none.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>parity=n</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>vpn setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">data</entry><entry align="left">separate variables named after keys of the dictionary</entry><entry align="left"/><entry align="left">The keys of the data dictionary are used as variable names directly under [vpn] section.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>remote=ovpn.corp.com cipher=AES-256-CBC username=joe</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">secrets</entry><entry align="left">separate variables named after keys of the dictionary</entry><entry align="left"/><entry align="left">The keys of the secrets dictionary are used as variable names directly under [vpn-secrets] section.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>password=Popocatepetl</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>wifi-p2p setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<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>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>802-3-ethernet setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address</entry><entry align="left">mac-address</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>
|
|
Packit Service |
b23acc |
<row><entry align="left">cloned-mac-address</entry><entry align="left">cloned-mac-address</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">Cloned MAC address in traditional hex-digits-and-colons notation (e.g. 00:22:68:12:79:B2), or semicolon separated list of 6 bytes (obsolete) (e.g. 0;34;104;18;121;178).</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address-blacklist</entry><entry align="left">mac-address-blacklist</entry><entry align="left">list of MACs (separated with semicolons)</entry><entry align="left">MAC address blacklist.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>mac-address-blacklist= 00:22:68:12:79:A6;00:22:68:12:79:78</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
<title>802-11-wireless setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">ssid</entry><entry align="left">ssid</entry><entry align="left">string (or decimal-byte list - obsolete)</entry><entry align="left">SSID of Wi-Fi network.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>ssid=Quick Net</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address</entry><entry align="left">mac-address</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>
|
|
Packit Service |
b23acc |
<row><entry align="left">cloned-mac-address</entry><entry align="left">cloned-mac-address</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">Cloned MAC address in traditional hex-digits-and-colons notation (e.g. 00:22:68:12:79:B2), or semicolon separated list of 6 bytes (obsolete) (e.g. 0;34;104;18;121;178).</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address-blacklist</entry><entry align="left">mac-address-blacklist</entry><entry align="left">list of MACs (separated with semicolons)</entry><entry align="left">MAC address blacklist.<emphasis role="bold">
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
Example: </emphasis>mac-address-blacklist= 00:22:68:12:79:A6;00:22:68:12:79:78</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
<title>wpan setting (section)</title><tgroup cols="4"><row><entry>Property</entry><entry>Keyfile Variable</entry><entry>Format</entry><entry>Description</entry></row>
|
|
Packit Service |
b23acc |
<row><entry align="left">mac-address</entry><entry align="left">mac-address</entry><entry align="left">usual hex-digits-and-colons notation</entry><entry align="left">MAC address in hex-digits-and-colons notation (e.g. 76:d8:9b:87:66:60:84:ee).</entry></row>
|
|
Packit Service |
b23acc |
</tgroup>
|
|
Packit Service |
b23acc |
<refsect2 id="secrets-flags"><title>Secret flags</title><para>
|
|
Packit Service |
b23acc |
Each secret property in a NetworkManager setting has an associated <emphasis>flags</emphasis>
|
|
Packit Service |
b23acc |
property that describes how to handle that secret. In the <emphasis>keyfile</emphasis> plugin,
|
|
Packit Service |
b23acc |
the value of <emphasis>-flags</emphasis> variable is a decimal number (0 - 7) defined as a sum
|
|
Packit Service |
b23acc |
of the following values:
|
|
Packit Service |
b23acc |
</para><itemizedlist><listitem><para>0 - (NM owned) - the system is responsible for providing and storing this secret.</para></listitem><listitem><para>1 - (agent-owned) - a user-session secret agent is responsible for providing
|
|
Packit Service |
b23acc |
and storing this secret; when it is required, agents will be asked to provide it.</para></listitem><listitem><para>2 - (not-saved) - this secret should not be saved but should be requested
|
|
Packit Service |
b23acc |
from the user each time it is required.</para></listitem><listitem><para>4 - (not-required) - in some situations it cannot be automatically determined
|
|
Packit Service |
b23acc |
that a secret is required or not. This flag hints that the secret is not required
|
|
Packit Service |
b23acc |
and should not be requested from the user.</para></listitem></itemizedlist></refsect2></refsect1><refsect1 id="files"><title>Files</title><para><filename>/etc/NetworkManager/system-connections/*</filename></para></refsect1><refsect1 id="see_also"><title>See Also</title><para><link linkend="nm-settings"><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>,
|
|
Packit Service |
b23acc |
<link linkend="nm-settings-ifcfg-rh"><citerefentry><refentrytitle>nm-settings-ifcfg-rh</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>,
|
|
Packit Service |
b23acc |
<link linkend="NetworkManager"><citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>,
|
|
Packit Service |
b23acc |
<link linkend="NetworkManager.conf"><citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></link>,
|
|
Packit Service |
b23acc |
<link linkend="nmcli"><citerefentry><refentrytitle>nmcli</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
|
|
Packit Service |
b23acc |
<link linkend="nmcli-examples"><citerefentry><refentrytitle>nmcli-examples</refentrytitle><manvolnum>7</manvolnum></citerefentry></link></para></refsect1></refentry>
|