|
Packit |
5756e2 |
'\" t
|
|
Packit |
5756e2 |
.\" Title: NetworkManager
|
|
Packit |
5756e2 |
.\" Author:
|
|
Packit |
5756e2 |
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
|
|
Packit Service |
5ffa24 |
.\" Date: 02/08/2021
|
|
Packit |
5756e2 |
.\" Manual: Network management daemons
|
|
Packit Service |
5ffa24 |
.\" Source: NetworkManager 1.29.11
|
|
Packit |
5756e2 |
.\" Language: English
|
|
Packit |
5756e2 |
.\"
|
|
Packit Service |
5ffa24 |
.TH "NETWORKMANAGER" "8" "" "NetworkManager 1\&.29\&.11" "Network management daemons"
|
|
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 |
NetworkManager \- network management daemon
|
|
Packit |
5756e2 |
.SH "SYNOPSIS"
|
|
Packit |
5756e2 |
.HP \w'\fBNetworkManager\ \fR\fB[OPTIONS...]\fR\ 'u
|
|
Packit |
5756e2 |
\fBNetworkManager \fR\fB[OPTIONS...]\fR
|
|
Packit |
5756e2 |
.SH "DESCRIPTION"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The NetworkManager daemon attempts to make networking configuration and operation as painless and automatic as possible by managing the primary network connection and other network interfaces, like Ethernet, Wi\-Fi, and Mobile Broadband devices\&. NetworkManager will connect any network device when a connection for that device becomes available, unless that behavior is disabled\&. Information about networking is exported via a D\-Bus interface to any interested application, providing a rich API with which to inspect and control network settings and operation\&.
|
|
Packit |
5756e2 |
.SH "DISPATCHER SCRIPTS"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
NetworkManager will execute scripts in the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d
|
|
Packit |
5756e2 |
directory or subdirectories in alphabetical order in response to network events\&. Each script should be a regular executable file owned by root\&. Furthermore, it must not be writable by group or other, and not setuid\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Each script receives two arguments, the first being the interface name of the device an operation just happened on, and second the action\&. For device actions, the interface is the name of the kernel interface suitable for IP configuration\&. Thus it is either VPN_IP_IFACE, DEVICE_IP_IFACE, or DEVICE_IFACE, as applicable\&. For the
|
|
Packit |
5756e2 |
\fIhostname\fR
|
|
Packit |
5756e2 |
action the device name is always
|
|
Packit |
5756e2 |
"none"
|
|
Packit |
5756e2 |
and for
|
|
Packit |
5756e2 |
\fIconnectivity\-change\fR
|
|
Packit |
5756e2 |
it is empty\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The actions are:
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIpre\-up\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The interface is connected to the network but is not yet fully activated\&. Scripts acting on this event must be placed or symlinked into the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d/pre\-up\&.d
|
|
Packit |
5756e2 |
directory, and NetworkManager will wait for script execution to complete before indicating to applications that the interface is fully activated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIup\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The interface has been activated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIpre\-down\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The interface will be deactivated but has not yet been disconnected from the network\&. Scripts acting on this event must be placed or symlinked into the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d/pre\-down\&.d
|
|
Packit |
5756e2 |
directory, and NetworkManager will wait for script execution to complete before disconnecting the interface from its network\&. Note that this event is not emitted for forced disconnections, like when carrier is lost or a wireless signal fades\&. It is only emitted when there is an opportunity to cleanly handle a network disconnection event\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIdown\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The interface has been deactivated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIvpn\-pre\-up\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The VPN is connected to the network but is not yet fully activated\&. Scripts acting on this event must be placed or symlinked into the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d/pre\-up\&.d
|
|
Packit |
5756e2 |
directory, and NetworkManager will wait for script execution to complete before indicating to applications that the VPN is fully activated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIvpn\-up\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
A VPN connection has been activated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIvpn\-pre\-down\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The VPN will be deactivated but has not yet been disconnected from the network\&. Scripts acting on this event must be placed or symlinked into the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d/pre\-down\&.d
|
|
Packit |
5756e2 |
directory, and NetworkManager will wait for script execution to complete before disconnecting the VPN from its network\&. Note that this event is not emitted for forced disconnections, like when the VPN terminates unexpectedly or general connectivity is lost\&. It is only emitted when there is an opportunity to cleanly handle a VPN disconnection event\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIvpn\-down\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
A VPN connection has been deactivated\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIhostname\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The system hostname has been updated\&. Use gethostname(2) to retrieve it\&. The interface name (first argument) is empty and no environment variable is set for this action\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIdhcp4\-change\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The DHCPv4 lease has changed (renewed, rebound, etc)\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIdhcp6\-change\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The DHCPv6 lease has changed (renewed, rebound, etc)\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIconnectivity\-change\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The network connectivity state has changed (no connectivity, went online, etc)\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The environment contains more information about the interface and the connection\&. The following variables are available for the use in the dispatcher scripts:
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fINM_DISPATCHER_ACTION\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The dispatcher action like "up" or "dhcp4\-change", identical to the first command line argument\&. Since NetworkManager 1\&.12\&.0\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTION_UUID\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The UUID of the connection profile\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTION_ID\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The name (ID) of the connection profile\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTION_DBUS_PATH\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The NetworkManager D\-Bus path of the connection\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTION_FILENAME\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The backing file name of the connection profile (if any)\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTION_EXTERNAL\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
If "1", this indicates that the connection describes a network configuration created outside of NetworkManager\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIDEVICE_IFACE\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The interface name of the control interface of the device\&. Depending on the device type, this differs from
|
|
Packit |
5756e2 |
\fIDEVICE_IP_IFACE\fR\&. For example for ADSL devices, this could be \*(Aqatm0\*(Aq or for WWAN devices it might be \*(AqttyUSB0\*(Aq\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIDEVICE_IP_IFACE\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The IP interface name of the device\&. This is the network interface on which IP addresses and routes will be configured\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_ADDRESS_N\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The IPv4 address in the format "address/prefix gateway", where N is a number from 0 to (# IPv4 addresses \- 1)\&. gateway item in this variable is deprecated, use IP4_GATEWAY instead\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_NUM_ADDRESSES\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The variable contains the number of IPv4 addresses the script may expect\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_GATEWAY\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The gateway IPv4 address in traditional numbers\-and\-dots notation\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_ROUTE_N\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The IPv4 route in the format "address/prefix next\-hop metric", where N is a number from 0 to (# IPv4 routes \- 1)\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_NUM_ROUTES\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The variable contains the number of IPv4 routes the script may expect\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_NAMESERVERS\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The variable contains a space\-separated list of the DNS servers\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP4_DOMAINS\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The variable contains a space\-separated list of the search domains\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIDHCP4_<dhcp\-option\-name>\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
If the connection used DHCP for address configuration, the received DHCP configuration is passed in the environment using standard DHCP option names, prefixed with "DHCP4_", like "DHCP4_HOST_NAME=foobar"\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fIIP6_<name> and DHCP6_<name>\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The same variables as for IPv4 are available for IPv6, but the prefixes are IP6_ and DHCP6_ instead\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fICONNECTIVITY_STATE\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The network connectivity state, which can take the values defined by the NMConnectivityState type, from the org\&.freedesktop\&.NetworkManager D\-Bus API: unknown, none, portal, limited or full\&. Note: this variable will only be set for connectivity\-change actions\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
In case of VPN, VPN_IP_IFACE is set, and IP4_*, IP6_* variables with VPN prefix are exported too, like VPN_IP4_ADDRESS_0, VPN_IP4_NUM_ADDRESSES\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Dispatcher scripts are run one at a time, but asynchronously from the main NetworkManager process, and will be killed if they run for too long\&. If your script might take arbitrarily long to complete, you should spawn a child process and have the parent return immediately\&. Scripts that are symbolic links pointing inside the
|
|
Packit |
5756e2 |
/etc/NetworkManager/dispatcher\&.d/no\-wait\&.d/
|
|
Packit |
5756e2 |
directory are run immediately, without waiting for the termination of previous scripts, and in parallel\&. Also beware that once a script is queued, it will always be run, even if a later event renders it obsolete\&. (Eg, if an interface goes up, and then back down again quickly, it is possible that one or more "up" scripts will be run after the interface has gone down\&.)
|
|
Packit |
5756e2 |
.SH "OPTIONS"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The following options are understood:
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-version\fR | \fB\-V\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Print the NetworkManager software version and exit\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-help\fR | \fB\-h\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Print NetworkManager\*(Aqs available options and exit\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-no\-daemon\fR | \fB\-n\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Do not daemonize\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-debug\fR | \fB\-d\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Do not daemonize, and direct log output to the controlling terminal in addition to syslog\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-pid\-file\fR | \fB\-p\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Specify location of a PID file\&. The PID file is used for storing PID of the running process and prevents running multiple instances\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-state\-file\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Specify file for storing state of the NetworkManager persistently\&. If not specified, the default value of
|
|
Packit |
5756e2 |
/var/lib/NetworkManager/NetworkManager\&.state
|
|
Packit |
5756e2 |
is used\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-config\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Specify configuration file to set up various settings for NetworkManager\&. If not specified, the default value of
|
|
Packit |
5756e2 |
/etc/NetworkManager/NetworkManager\&.conf
|
|
Packit |
5756e2 |
is used with a fallback to the older \*(Aqnm\-system\-settings\&.conf\*(Aq if located in the same directory\&. See
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)
|
|
Packit |
5756e2 |
for more information on configuration file\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-configure\-and\-quit\fR [initrd]
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Quit after all devices reach a stable state\&. The optional
|
|
Packit |
5756e2 |
initrd
|
|
Packit |
5756e2 |
parameter enables mode, where no processes are left running after NetworkManager stops, which is useful for running from an initial ramdisk on rearly boot\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-plugins\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
List plugins used to manage system\-wide connection settings\&. This list has preference over plugins specified in the configuration file\&. See
|
|
Packit |
5756e2 |
main\&.plugins
|
|
Packit |
5756e2 |
setting in
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)
|
|
Packit |
5756e2 |
for supported options\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-log\-level\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Sets how much information NetworkManager sends to the log destination (usually syslog\*(Aqs "daemon" facility)\&. By default, only informational, warning, and error messages are logged\&. See the section on
|
|
Packit |
5756e2 |
logging
|
|
Packit |
5756e2 |
in
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)
|
|
Packit |
5756e2 |
for more information\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-log\-domains\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
A comma\-separated list specifying which operations are logged to the log destination (usually syslog)\&. By default, most domains are logging\-enabled\&. See the section on
|
|
Packit |
5756e2 |
logging
|
|
Packit |
5756e2 |
in
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)
|
|
Packit |
5756e2 |
for more information\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fB\-\-print\-config\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
Print the NetworkManager configuration to stdout and exit\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.SH "UDEV PROPERTIES"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fBudev\fR(7)
|
|
Packit |
5756e2 |
device manager is used for the network device discovery\&. The following property influences how NetworkManager manages the devices:
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fINM_UNMANAGED\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
If set to
|
|
Packit |
5756e2 |
"1"
|
|
Packit |
5756e2 |
or
|
|
Packit |
5756e2 |
"true", the device is configured as unmanaged by NetworkManager\&. Note that the user still can explicitly overrule this configuration via means like
|
|
Packit |
5756e2 |
\fBnmcli device set "$DEVICE" managed yes\fR
|
|
Packit |
5756e2 |
or
|
|
Packit |
5756e2 |
"device*\&.managed=1"
|
|
Packit |
5756e2 |
in NetworkManager\&.conf\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.SH "SIGNALS"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
NetworkManager process handles the following signals:
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fISIGHUP\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The signal causes a reload of NetworkManager\*(Aqs configuration\&. Note that not all configuration parameters can be changed at runtime and therefore some changes may be applied only after the next restart of the daemon\&. A SIGHUP also involves further reloading actions, like doing a DNS update and restarting the DNS plugin\&. The latter can be useful for example when using the dnsmasq plugin and changing its configuration in
|
|
Packit |
5756e2 |
/etc/NetworkManager/dnsmasq\&.d\&. However, it also means this will shortly interrupt name resolution\&. In the future, there may be further actions added\&. A SIGHUP means to update NetworkManager configuration and reload everything that is supported\&. Note that this does not reload connections from disk\&. For that there is a D\-Bus API and nmcli\*(Aqs reload action
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fISIGUSR1\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The signal forces a rewrite of DNS configuration\&. Contrary to SIGHUP, this does not restart the DNS plugin and will not interrupt name resolution\&. In the future, further actions may be added\&. A SIGUSR1 means to write out data like resolv\&.conf, or refresh a cache\&. It is a subset of what is done for SIGHUP without reloading configuration from disk\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\fISIGUSR2\fR
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
The signal has no effect at the moment but is reserved for future use\&.
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
An alternative to a signal to reload configuration is the Reload D\-Bus call\&. It allows for more fine\-grained selection of what to reload, it only returns after the reload is complete, and it is guarded by PolicyKit\&.
|
|
Packit |
5756e2 |
.SH "DEBUGGING"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
NetworkManager only configures your system\&. So when your networking setup doesn\*(Aqt work as expected, the first step is to look at your system to understand what is actually configured, and whether that is correct\&. The second step is to find out how to tell NetworkManager to do the right thing\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
You can for example try to
|
|
Packit |
5756e2 |
\fBping\fR
|
|
Packit |
5756e2 |
hosts (by IP address or DNS name), look at
|
|
Packit |
5756e2 |
\fBip link show\fR,
|
|
Packit |
5756e2 |
\fBip address show\fR
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
\fBip route show\fR, and look at
|
|
Packit |
5756e2 |
/etc/resolv\&.conf
|
|
Packit |
5756e2 |
for name resolution issues\&. Also look at the connection profiles that you have configured in NetworkManager (\fBnmcli connection\fR
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
\fBnmcli connection show "$PROFILE"\fR) and the configured interfaces (\fBnmcli device\fR)\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
If that does not suffice, look at the logfiles of NetworkManager\&. NetworkManager logs to syslog, so depending on your system configuration you can call
|
|
Packit |
5756e2 |
\fBjournalctl\fR
|
|
Packit |
5756e2 |
to get the logs\&. By default, NetworkManager logs are not verbose and thus not very helpful for investigating a problem in detail\&. You can change the logging level at runtime with
|
|
Packit |
5756e2 |
\fBnmcli general logging level TRACE domains ALL\fR\&. But usually a better way is to collect full logs from the start, by configuring
|
|
Packit |
5756e2 |
level=TRACE
|
|
Packit |
5756e2 |
in NetworkManager\&.conf\&. See
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5)
|
|
Packit |
5756e2 |
manual\&. Note that trace logs of NetworkManager are verbose and systemd\-journald might rate limit some lines\&. Possibly disable rate limiting first with the
|
|
Packit |
5756e2 |
RateLimitIntervalSec
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
RateLimitBurst
|
|
Packit |
5756e2 |
options of journald (see
|
|
Packit |
5756e2 |
\fBjournald.conf\fR(5)
|
|
Packit |
5756e2 |
manual)\&.
|
|
Packit |
5756e2 |
.SH "/VAR/LIB/NETWORKMANAGER/SECRET_KEY AND /ETC/MACHINE\-ID"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The identity of a machine is important as various settings depend on it\&. For example,
|
|
Packit |
5756e2 |
ipv6\&.addr\-gen\-mode=stable
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
ethernet\&.cloned\-mac\-address=stable
|
|
Packit |
5756e2 |
generate identifiers by hashing the machine\*(Aqs identity\&. See also the
|
|
Packit |
5756e2 |
connection\&.stable\-id
|
|
Packit |
5756e2 |
connection property which is a per\-profile seed that gets hashed with the machine identity for generating such addresses and identifiers\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
If you backup and restore a machine, the identity of the machine probably should be preserved\&. In that case, preserve the files
|
|
Packit |
5756e2 |
/var/lib/NetworkManager/secret_key
|
|
Packit |
5756e2 |
and
|
|
Packit |
5756e2 |
/etc/machine\-id\&. On the other hand, if you clone a virtual machine, you probably want that the clone has a different identity\&. There is already existing tooling on Linux for handling
|
|
Packit |
5756e2 |
/etc/machine\-id
|
|
Packit |
5756e2 |
(see
|
|
Packit |
5756e2 |
\fBmachine-id\fR(5))\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
The identity of the machine is determined by the
|
|
Packit |
5756e2 |
/var/lib/NetworkManager/secret_key\&. If such a file does not exist, NetworkManager will create a file with random content\&. To generate a new identity just delete the file and after restart a new file will be created\&. The file should be read\-only to root and contain at least 16 bytes that will be used to seed the various places where a stable identifier is used\&.
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Since 1\&.16\&.0, NetworkManager supports a version 2 of secret\-keys\&. For such keys
|
|
Packit |
5756e2 |
/var/lib/NetworkManager/secret_key
|
|
Packit |
5756e2 |
starts with ASCII
|
|
Packit |
5756e2 |
"nm\-v2:"
|
|
Packit |
5756e2 |
followed by at least 32 bytes of random data\&. Also, recent versions of NetworkManager always create such kinds of secret\-keys, when the file does not yet exist\&. With version 2 of the secret\-key,
|
|
Packit |
5756e2 |
/etc/machine\-id
|
|
Packit |
5756e2 |
is also hashed as part of the generation for addresses and identifiers\&. The advantage is that you can keep
|
|
Packit |
5756e2 |
/var/lib/NetworkManager/secret_key
|
|
Packit |
5756e2 |
stable, and only regenerate
|
|
Packit |
5756e2 |
/etc/machine\-id
|
|
Packit |
5756e2 |
when cloning a VM\&.
|
|
Packit |
5756e2 |
.SH "BUGS"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
Please report any bugs you find in NetworkManager at the
|
|
Packit |
5756e2 |
\m[blue]\fBNetworkManager issue tracker\fR\m[]\&\s-2\u[1]\d\s+2\&.
|
|
Packit |
5756e2 |
.SH "SEE ALSO"
|
|
Packit |
5756e2 |
.PP
|
|
Packit |
5756e2 |
\m[blue]\fBNetworkManager home page\fR\m[]\&\s-2\u[2]\d\s+2,
|
|
Packit |
5756e2 |
\fBNetworkManager.conf\fR(5),
|
|
Packit |
5756e2 |
\fBnmcli\fR(1),
|
|
Packit |
5756e2 |
\fBnmcli-examples\fR(7),
|
|
Packit |
5756e2 |
\fBnm-online\fR(1),
|
|
Packit |
5756e2 |
\fBnm-settings\fR(5),
|
|
Packit |
5756e2 |
\fBnm-applet\fR(1),
|
|
Packit |
5756e2 |
\fBnm-connection-editor\fR(1),
|
|
Packit |
5756e2 |
\fBudev\fR(7)
|
|
Packit |
5756e2 |
.SH "NOTES"
|
|
Packit |
5756e2 |
.IP " 1." 4
|
|
Packit |
5756e2 |
NetworkManager issue tracker
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
\%https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/issues
|
|
Packit |
5756e2 |
.RE
|
|
Packit |
5756e2 |
.IP " 2." 4
|
|
Packit |
5756e2 |
NetworkManager home page
|
|
Packit |
5756e2 |
.RS 4
|
|
Packit |
5756e2 |
\%https://wiki.gnome.org/Projects/NetworkManager
|
|
Packit |
5756e2 |
.RE
|