Provided by: network-manager_0.8.1+git.20100810t184654.ab580f4-0ubuntu2_i386 bug

NAME

       NetworkManager - network management daemon

SYNOPSIS

       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.

       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.

OPTIONS

       The following options are supported:

       --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), NetworkManager.conf(5).

                               January 29, 2010              NETWORKMANAGER(8)