NAME¶
NetworkManager - network management daemon
SYNOPSIS¶
NetworkManager [--version] | [--help]
NetworkManager [--no-daemon] [--pid-file=<filename>]
[--state-file=<filename>] [--config=<filename>]
[--plugins=<plugin1>,plugin2>,...] [--log-level=<level>]
[--log-domains=<domain1>,<domain2>,...]
DESCRIPTION¶
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, WiFi, 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.
NetworkManager will execute scripts in the /etc/NetworkManager/dispatcher.d
directory in alphabetical order in response to network events. Each script
should be:
- (a)
- a regular file
- (b)
- owned by root
- (c)
- not writable by group or other
- (d)
- not set-uid
- (e)
- and executable by the owner
Each script receives two arguments, the first being the interface name of the
device just activated, and second an action.
Actions:
- up
- The interface has been activated. The environment contains
more information about the interface; CONNECTION_UUID contains the UUID of
the connection. Other variables are IP4_ADDRESS_N where N is a number from
0 to (# IPv4 addresses - 1), in the format "address/prefix
gateway". IP4_NUM_ADDRESSES contains the number addresses the script
may expect. IP4_NAMESERVERS contains a space-separated list of the DNS
servers, and IP4_DOMAINS contains a space-separated list of the search
domains. Routes use the format IP4_ROUTE_N where N is a number from 0 to
(# IPv4 routes - 1), in the format "address/prefix next-hop
metric", and IP4_NUM_ROUTES contains the number of routes to expect.
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".
- down
- The interface has been deactivated.
- vpn-up
- A VPN connection has been activated. The environment
contains the connection UUID in the variable CONNECTION_UUID.
- vpn-down
- A VPN connection has been deactivated.
- hostname
- The system hostname has been updated. Use gethostname(2) to
retrieve it.
- dhcp4-change
- The DHCPv4 lease has changed (renewed, rebound, etc).
- dhcp6-change
- The DHCPv6 lease has changed (renewed, rebound, etc).
OPTIONS¶
The following options are supported:
- --version
- Print the NetworkManager software version and exit.
- --help
- Print NetworkManager's available options and exit.
- --no-daemon
- Do not daemonize. This is useful for debugging, and directs
log output to the controlling terminal in addition to syslog.
- --pid-file=<filename>
- Specify location of a PID file. The PID file is used for
storing PID of the running proccess and prevents running multiple
instances.
- --state-file=<filename>
- Specify file for storing state of the NetworkManager
persistently. If not specified, the default value of
'<LOCALSTATEDIR>/lib/NetworkManager/NetworkManager.state' is used;
where <LOCALSTATEDIR> is dependent on your distribution (usually
it's /var).
- --config=<filename>
- Specify configuration file to set up various settings for
NetworkManager. If not specified, the default value of
'<SYSCONFDIR>/NetworkManager/NetworkManager.conf' is used with a
fallback to the older 'nm-system-settings.conf' if located in the same
directory; where <SYSCONFDIR> is dependent on your distribution
(usually it's /etc). See NetworkManager.conf(5) for more
information on configuration file.
- --plugins=<plugin1>,<plugin2>, ...
- List plugins used to manage system-wide connection
settings. This list has preference over plugins specified in the
configuration file. Currently supported plugins are: keyfile, ifcfg-rh,
ifcfg-suse, ifupdown. See NetworkManager.conf(5) for more
information on the plugins.
- --log-level=<level>
- Sets how much information NetworkManager sends to the log
destination (usually syslog's "daemon" facility). By default,
only informational, warning, and error messages are logged. See
NetworkManager.conf(5) for more information on log levels and
domains.
- --log-domains=<domain1>,<domain2>,
...
- Sets which operations are logged to the log destination
(usually syslog). By default, most domains are logging-enabled. See
NetworkManager.conf(5) for more information on log levels and
domains.
DEBUGGING¶
The following environment variables are supported to help debugging. When used
in conjunction with the "--no-daemon" option (thus echoing PPP and
DHCP helper output to stdout) these can quickly help pinpoint the source of
connection issues. Also see the --log-level and --log-domains to enable debug
logging inside NetworkManager itself.
- NM_PPP_DEBUG
- When set to anything, causes NetworkManager to turn on PPP
debugging in pppd, which logs all PPP and PPTP frames and client/server
exchanges.
SEE ALSO¶
nm-tool(1),
nm-online(1),
nmcli(1),
NetworkManager.conf(5).