Provided by: network-manager_0.9.8.8-0ubuntu7.3_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>,...]                         [--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

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

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

SEE ALSO

       nm-tool(1),  nm-online(1), nmcli(1), NetworkManager.conf(5), nm-settings(5), nm-applet(1),
       nm-connection-editor(1).

                                         17 January 2012                        NETWORKMANAGER(8)