Provided by: network-manager_0.9.4.0-0ubuntu3_amd64 bug

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

                                          2 August 2011                         NETWORKMANAGER(8)