|
Packit |
5756e2 |
'\" t
|
|
Packit |
5756e2 |
.\" Title: nm-settings-keyfile
|
|
Packit |
5756e2 |
.\" Author:
|
|
Packit |
5756e2 |
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
|
|
Packit Service |
c219b0 |
.\" Date: 01/19/2021
|
|
Packit |
5756e2 |
.\" Manual: Configuration
|
|
Packit Service |
c219b0 |
.\" Source: NetworkManager 1.29.9
|
|
Packit |
5756e2 |
.\" Language: English
|
|
Packit |
5756e2 |
.\"
|
|
Packit Service |
c219b0 |
.TH "NM\-SETTINGS\-KEYFILE" "5" "" "NetworkManager 1\&.29\&.9" "Configuration"
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.\" * Define some portability stuff
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Packit |
5756e2 |
.\" http://bugs.debian.org/507673
|
|
Packit |
5756e2 |
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
Packit |
5756e2 |
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Packit |
5756e2 |
.ie \n(.g .ds Aq \(aq
|
|
Packit |
5756e2 |
.el .ds Aq '
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.\" * set default formatting
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.\" disable hyphenation
|
|
Packit |
5756e2 |
.nh
|
|
Packit |
5756e2 |
.\" disable justification (adjust text to left margin only)
|
|
Packit |
5756e2 |
.ad l
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.\" * MAIN CONTENT STARTS HERE *
|
|
Packit |
5756e2 |
.\" -----------------------------------------------------------------
|
|
Packit |
5756e2 |
.SH "NAME"
|
|
Packit |
5756e2 |
nm-settings-keyfile \- Description of \fIkeyfile\fR settings plugin
|
|
Packit |
5756e2 |
.SH "DESCRIPTION"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
NetworkManager is based on the concept of connection profiles that contain network configuration (see
|
|
Packit |
5756e2 |
\fBnm-settings\fR(5)
|
|
Packit |
5756e2 |
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
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
plugin is the generic plugin that supports all the connection types and capabilities that NetworkManager has\&. The files are in a \&.ini\-style format and located in
|
|
Packit |
5756e2 |
/etc/NetworkManager/system\-connections/,
|
|
Packit |
5756e2 |
/usr/lib/NetworkManager/system\-connections/
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
/run/NetworkManager/system\-connections/\&. 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 other than \*(Aqroot\*(Aq since private keys and passphrases may be stored in plaintext inside the file\&.
|
|
Packit |
5756e2 |
.SH "FILE FORMAT"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
config format is a simple \&.ini\-style format\&. It consists of sections (groups) of key\-value pairs\&. Each section corresponds to a setting name as described in the settings specification (\fBnm-settings\fR(5))\&. Each configuration key/value pair in the section is one of the properties listed in the settings specification\&. The majority of properties of the specification is written in the same format into the
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
too\&. However some values are inconvenient for people to use\&. These are stored in the files in more readable ways\&. These properties are described below\&. An example could be IP addresses that are not written as integer arrays, but more reasonably as "1\&.2\&.3\&.4/12 1\&.2\&.3\&.254"\&. More information of the generic key file format can be found at
|
|
Packit |
5756e2 |
\m[blue]\fBGLib key file format\fR\m[]\&\s-2\u[1]\d\s+2
|
|
Packit |
5756e2 |
(Lines beginning with a \*(Aq#\*(Aq are comments, lists are separated by character
|
|
Packit |
5756e2 |
;
|
|
Packit |
5756e2 |
etc\&.)\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Users can create or modify the
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
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 (for example via
|
|
Packit |
5756e2 |
\fInmcli con (re)load\fR)\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fBExamples of keyfile configuration\fR.
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.nf
|
|
Packit |
5756e2 |
\fBA sample configuration for an ethernet network:\fR
|
|
Packit |
5756e2 |
[connection]
|
|
Packit |
5756e2 |
id=Main eth0
|
|
Packit |
5756e2 |
uuid=27afa607\-ee36\-43f0\-b8c3\-9d245cdc4bb3
|
|
Packit |
5756e2 |
type=802\-3\-ethernet
|
|
Packit |
5756e2 |
autoconnect=true
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[ipv4]
|
|
Packit |
5756e2 |
method=auto
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[802\-3\-ethernet]
|
|
Packit |
5756e2 |
mac\-address=00:23:5a:47:1f:71
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.fi
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.nf
|
|
Packit |
5756e2 |
\fBA sample configuration for WPA\-EAP (PEAP with MSCHAPv2) and always\-ask secret:\fR
|
|
Packit |
5756e2 |
[connection]
|
|
Packit |
5756e2 |
id=CompanyWIFI
|
|
Packit |
5756e2 |
uuid=cdac6154\-a33b\-4b15\-9904\-666772cfa5ee
|
|
Packit |
5756e2 |
type=wifi
|
|
Packit |
5756e2 |
autoconnect=false
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[wifi]
|
|
Packit |
5756e2 |
ssid=CorpWLAN
|
|
Packit |
5756e2 |
mode=infrastructure
|
|
Packit |
5756e2 |
security=802\-11\-wireless\-security
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[wifi\-security]
|
|
Packit |
5756e2 |
key\-mgmt=wpa\-eap
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[ipv4]
|
|
Packit |
5756e2 |
method=auto
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[ipv6]
|
|
Packit |
5756e2 |
method=auto
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[802\-1x]
|
|
Packit |
5756e2 |
eap=peap;
|
|
Packit |
5756e2 |
identity=joe
|
|
Packit |
5756e2 |
ca\-cert=/home/joe/\&.cert/corp\&.crt
|
|
Packit |
5756e2 |
phase1\-peapver=1
|
|
Packit |
5756e2 |
phase2\-auth=mschapv2
|
|
Packit |
5756e2 |
password\-flags=2
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.fi
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.nf
|
|
Packit |
5756e2 |
\fBA sample configuration for openvpn:\fR
|
|
Packit |
5756e2 |
[connection]
|
|
Packit |
5756e2 |
id=RedHat\-openvpn
|
|
Packit |
5756e2 |
uuid=7f9b3356\-b210\-4c0e\-8123\-bd116c9c280f
|
|
Packit |
5756e2 |
type=vpn
|
|
Packit |
5756e2 |
timestamp=1385401165
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[vpn]
|
|
Packit |
5756e2 |
service\-type=org\&.freedesktop\&.NetworkManager\&.openvpn
|
|
Packit |
5756e2 |
connection\-type=password
|
|
Packit |
5756e2 |
password\-flags=3
|
|
Packit |
5756e2 |
remote=ovpn\&.my\-company\&.com
|
|
Packit |
5756e2 |
cipher=AES\-256\-CBC
|
|
Packit |
5756e2 |
reneg\-seconds=0
|
|
Packit |
5756e2 |
port=443
|
|
Packit |
5756e2 |
username=joe
|
|
Packit |
5756e2 |
ca=/etc/openvpn/ISCA\&.pem
|
|
Packit |
5756e2 |
tls\-remote=ovpn\&.my\-company\&.com
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[ipv6]
|
|
Packit |
5756e2 |
method=auto
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[ipv4]
|
|
Packit |
5756e2 |
method=auto
|
|
Packit |
5756e2 |
ignore\-auto\-dns=true
|
|
Packit |
5756e2 |
never\-default=true
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.fi
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.nf
|
|
Packit |
5756e2 |
\fBA sample configuration for a bridge and a bridge port:\fR
|
|
Packit |
5756e2 |
[connection] [connection]
|
|
Packit |
5756e2 |
id=MainBridge id=br\-port\-1
|
|
Packit |
5756e2 |
uuid=171ae855\-a0ab\-42b6\-bd0c\-60f5812eea9d uuid=d6e8ae98\-71f8\-4b3d\-9d2d\-2e26048fe794
|
|
Packit |
5756e2 |
interface\-name=MainBridge interface\-name=em1
|
|
Packit |
5756e2 |
type=bridge type=ethernet
|
|
Packit |
5756e2 |
master=MainBridge
|
|
Packit |
5756e2 |
[bridge] slave\-type=bridge
|
|
Packit |
5756e2 |
interface\-name=MainBridge
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.fi
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.nf
|
|
Packit |
5756e2 |
\fBA sample configuration for a VLAN:\fR
|
|
Packit |
5756e2 |
[connection]
|
|
Packit |
5756e2 |
id=VLAN for building 4A
|
|
Packit |
5756e2 |
uuid=8ce1c9e0\-ce7a\-4d2c\-aa28\-077dda09dd7e
|
|
Packit |
5756e2 |
interface\-name=VLAN\-4A
|
|
Packit |
5756e2 |
type=vlan
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
[vlan]
|
|
Packit |
5756e2 |
interface\-name=VLAN\-4A
|
|
Packit |
5756e2 |
parent=eth0
|
|
Packit |
5756e2 |
id=4
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
.fi
|
|
Packit |
5756e2 |
.if n \{\
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.SH "DETAILS"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
plugin variables for the majority of NetworkManager properties have one\-to\-one mapping\&. It means a NetworkManager property is stored in the keyfile as a variable of the same name and in the same format\&. There are several exceptions to this rule, mainly for making keyfile syntax easier for humans\&. The exceptions handled specially by
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
plugin are listed below\&. Refer to
|
|
Packit |
5756e2 |
\fBnm-settings\fR(5)
|
|
Packit |
5756e2 |
for all available settings and properties and their description\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fBName aliases\fR. Some of the NetworkManager setting names are somewhat hard to type or remember\&. Therefore
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
introduces aliases that can be used instead of the names\&.
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
\fIsetting name keyfile alias\fR
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
802\-3\-ethernet = ethernet
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
802\-11\-wireless = wifi
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
802\-11\-wireless\-security = wifi\-security
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&1.\ \&bridge setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
MAC address in traditional hex\-digits\-and\-colons notation, or semicolon separated list of 6 decimal bytes (obsolete)\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRmac\-address=00:22:68:12:79:A2 mac\-address=0;34;104;18;121;162;
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&2.\ \&infiniband setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
MAC address in traditional hex\-digits\-and\-colons notation, or or semicolon separated list of 20 decimal bytes (obsolete)\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRmac\-address= 80:00:00:6d:fe:80:00:00:00:00:00:00:00:02:55:00:70:33:cf:01
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&3.\ \&ipv4 setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
dns
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
dns
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
list of DNS IP addresses
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of DNS servers\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRdns=1\&.2\&.3\&.;;8\&.8\&.8\&.;;8\&.8\&.4\&.;;
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
addresses
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
address1, address2, \&.\&.\&.
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
address/plen
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of static IP addresses\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRaddress1=192\&.168\&.100\&.100/24 address2=10\&.1\&.1\&.5/24
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
gateway
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
gateway
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
string
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Gateway IP addresses as a string\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRgateway=192\&.168\&.100\&.1
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
routes
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
route1, route2, \&.\&.\&.
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
route/plen[,gateway,metric]
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of IP routes\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRroute1=8\&.8\&.8\&.0/24,10\&.1\&.1\&.1,77 route2=7\&.7\&.0\&.0/16
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&4.\ \&ipv6 setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
dns
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
dns
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
list of DNS IP addresses
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of DNS servers\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRdns=2001:4860:4860::8888;2001:4860:4860::8844;
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
addresses
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
address1, address2, \&.\&.\&.
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
address/plen
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of static IP addresses\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRaddress1=abbe::cafe/96 address2=2001::1234
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
gateway
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
gateway
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
string
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Gateway IP addresses as a string\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRgateway=abbe::1
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
routes
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
route1, route2, \&.\&.\&.
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
route/plen[,gateway,metric]
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
List of IP routes\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRroute1=2001:4860:4860::/64,2620:52:0:2219:222:68ff:fe11:5403
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&5.\ \&serial setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
parity
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
parity
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
\*(Aqe\*(Aq, \*(Aqo\*(Aq, or \*(Aqn\*(Aq
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
The connection parity; even, odd, or none\&. Note that older versions of NetworkManager stored this as an integer: 69 (\*(AqE\*(Aq) for even, 111 (\*(Aqo\*(Aq) for odd, or 110 (\*(Aqn\*(Aq) for none\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRparity=n
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&6.\ \&vpn setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
data
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
separate variables named after keys of the dictionary
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
\ \&
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
The keys of the data dictionary are used as variable names directly under [vpn] section\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRremote=ovpn\&.corp\&.com cipher=AES\-256\-CBC username=joe
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
secrets
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
separate variables named after keys of the dictionary
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
\ \&
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
The keys of the secrets dictionary are used as variable names directly under [vpn\-secrets] section\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRpassword=Popocatepetl
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&7.\ \&wifi\-p2p setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
peer
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
peer
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
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)\&.
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&8.\ \&802\-3\-ethernet setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
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)
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
cloned\-mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
cloned\-mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
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)\&.
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address\-blacklist
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address\-blacklist
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
list of MACs (separated with semicolons)
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
MAC address blacklist\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRmac\-address\-blacklist= 00:22:68:12:79:A6;00:22:68:12:79:78
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&9.\ \&802\-11\-wireless setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
ssid
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
ssid
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
string (or decimal\-byte list \- obsolete)
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
SSID of Wi\-Fi network\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRssid=Quick Net
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
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)\&.
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
cloned\-mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
cloned\-mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
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)\&.
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address\-blacklist
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address\-blacklist
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
list of MACs (separated with semicolons)
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
MAC address blacklist\&.\fB
|
|
Packit |
5756e2 |
|
|
Packit |
5756e2 |
Example: \fRmac\-address\-blacklist= 00:22:68:12:79:A6;00:22:68:12:79:78
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.it 1 an-trap
|
|
Packit |
5756e2 |
.nr an-no-space-flag 1
|
|
Packit |
5756e2 |
.nr an-break-flag 1
|
|
Packit |
5756e2 |
.br
|
|
Packit |
5756e2 |
.B Table\ \&10.\ \&wpan setting (section)
|
|
Packit |
5756e2 |
.TS
|
|
Packit |
5756e2 |
allbox tab(:);
|
|
Packit |
5756e2 |
lB lB lB lB.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
Property
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Keyfile Variable
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Format
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
Description
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.T&
|
|
Packit |
5756e2 |
l l l l.
|
|
Packit |
5756e2 |
T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
mac\-address
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
usual hex\-digits\-and\-colons notation
|
|
Packit |
5756e2 |
T}:T{
|
|
Packit |
5756e2 |
MAC address in hex\-digits\-and\-colons notation (e\&.g\&. 76:d8:9b:87:66:60:84:ee)\&.
|
|
Packit |
5756e2 |
T}
|
|
Packit |
5756e2 |
.TE
|
|
Packit |
5756e2 |
.sp 1
|
|
Packit |
5756e2 |
.SS "Secret flags"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Each secret property in a NetworkManager setting has an associated
|
|
Packit |
5756e2 |
\fIflags\fR
|
|
Packit |
5756e2 |
property that describes how to handle that secret\&. In the
|
|
Packit |
5756e2 |
\fIkeyfile\fR
|
|
Packit |
5756e2 |
plugin, the value of
|
|
Packit |
5756e2 |
\fI\-flags\fR
|
|
Packit |
5756e2 |
variable is a decimal number (0 \- 7) defined as a sum of the following values:
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.ie n \{\
|
|
Packit |
5756e2 |
\h'-04'\(bu\h'+03'\c
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.el \{\
|
|
Packit |
5756e2 |
.sp -1
|
|
Packit |
5756e2 |
.IP \(bu 2.3
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
0 \- (NM owned) \- the system is responsible for providing and storing this secret\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.ie n \{\
|
|
Packit |
5756e2 |
\h'-04'\(bu\h'+03'\c
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.el \{\
|
|
Packit |
5756e2 |
.sp -1
|
|
Packit |
5756e2 |
.IP \(bu 2.3
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
1 \- (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\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.ie n \{\
|
|
Packit |
5756e2 |
\h'-04'\(bu\h'+03'\c
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.el \{\
|
|
Packit |
5756e2 |
.sp -1
|
|
Packit |
5756e2 |
.IP \(bu 2.3
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
2 \- (not\-saved) \- this secret should not be saved but should be requested from the user each time it is required\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.sp
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
.ie n \{\
|
|
Packit |
5756e2 |
\h'-04'\(bu\h'+03'\c
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
.el \{\
|
|
Packit |
5756e2 |
.sp -1
|
|
Packit |
5756e2 |
.IP \(bu 2.3
|
|
Packit |
5756e2 |
.\}
|
|
Packit |
5756e2 |
4 \- (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\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.SH "FILES"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
/etc/NetworkManager/system\-connections/*
|
|
Packit |
5756e2 |
.SH "SEE ALSO"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fBnm-settings\fR(5),
|
|
Packit |
5756e2 |
\fBnm-settings-ifcfg-rh\fR(5),
|
|
Packit |
5756e2 |
\fBNetworkManager\fR(8),
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5),
|
|
Packit |
5756e2 |
\fBnmcli\fR(1),
|
|
Packit |
5756e2 |
\fBnmcli-examples\fR(7)
|
|
Packit |
5756e2 |
.SH "NOTES"
|
|
Packit |
5756e2 |
.IP " 1." 4
|
|
Packit |
5756e2 |
GLib key file format
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
\%https://developer.gnome.org/glib/stable/glib-Key-value-file-parser.html#glib-Key-value-file-parser.description
|
|
Packit |
5756e2 |
.RE
|