Ubuntu Manpage: NetworkManager - network management daemon

Provided by: network-manager_0.9.8.8-0ubuntu7.3_amd64

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>,...]
       [--connectivity-uri=<uri>] [--connectivity-interval=<int>] [--connectivity-response=<resp>]

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

(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.

       --connectivity-uri=<uri>
              Sets  the  URI  of a web page that will be used for connectivity checking. By default connectivity
              checking is disabled.  See NetworkManager.conf(5) [connectivity] section for more  information  on
              connectivity checking feature.

       --connectivity-interval=<int>
              Sets  the  interval  (in  seconds)  in  which  connection checks for the URI are done.  0 means no
              checks. The default value is 300 seconds. See NetworkManager.conf(5)  [connectivity]  section  for
              more information on connectivity checking feature.

       --connectivity-response=<resp>
              If  set,  it  controls  what  body  content  NetworkManager checks for when requesting the URI for
              connectivity   checking.    If   missing,   defaults   to   "NetworkManager   is   online".    See
              NetworkManager.conf(5)  [connectivity]  section  for  more  information  on  connectivity checking
              feature.

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.

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

DEBUGGING

SEE ALSO