Commit 5ce04311 authored by Dan Williams's avatar Dan Williams

man: fix up manpages; document dispatcher stuff

parent 470770c7
.\" NetworkManager(8) manual page .\" NetworkManager(8) manual page
.\" .\"
.\" Copyright (C) 2005 - 2009 Red Hat, Inc.
.\" Copyright (C) 2005 - 2009 Novell, Inc.
.\" Copyright (C) 2005 Robert Love .\" Copyright (C) 2005 Robert Love
.\" .\"
.TH NETWORKMANAGER "8" .TH NETWORKMANAGER "8"
.SH NAME .SH NAME
NetworkManager \- network management daemon NetworkManager \- network management daemon
.SH SYNOPSIS .SH SYNOPSIS
.B NetworkManager [\-\-no-daemon] [\-\-enable-test-devices] .B NetworkManager [\-\-no-daemon]
.SH DESCRIPTION .SH DESCRIPTION
The \fINetworkManager\fP daemon attempts to keep an active network connection The \fINetworkManager\fP daemon attempts to make networking configuration and
available at all times. The point of NetworkManager is to make networking operation as painless and automatic as possible by managing the primary network
configuration and setup as painless and automatic as possible. If using DHCP, connection and other network interfaces, like Ethernet, WiFi, and Mobile
NetworkManager is intended to replace default routes, obtain IP addresses from Broadband devices. NetworkManager will connect any network device when a
a DHCP server, and change nameservers whenever it sees fit, with the aim of connection for that device becomes available, unless that behavior is disabled.
making networking Just Work. 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.
.TP
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.
.TP
.I "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".
.TP
.I "down"
The interface has been deactivated.
.TP
.I "vpn-up"
A VPN connection has been activated. The environment contains the connection
UUID in the variable CONNECTION_UUID.
.TP
.I "vpn-down"
A VPN connection has been deactivated.
.TP
.I "hostname"
The system hostname has been updated. Use gethostname(2) to retrieve it.
.SH OPTIONS .SH OPTIONS
The following options are supported: The following options are supported:
.TP .TP
.I "--no-daemon" .I "--no-daemon"
Do not daemonize. This is useful for debugging. Do not daemonize. This is useful for debugging, and directs log output to the
.TP controlling terminal in addition to syslog.
.I "--enable-test-devices"
Enable support for virtual test devices. These are useful for debugging.
.SH SEE ALSO .SH SEE ALSO
.BR NetworkManagerDispatcher (8),
.BR nm-tool (1) .BR nm-tool (1)
.\" nm-tool(1) manual page .\" nm-tool(1) manual page
.\" .\"
.\" Copyright (C) 2005 - 2009 Red Hat, Inc.
.\" Copyright (C) 2005 - 2009 Novell, Inc.
.\" Copyright (C) 2005 Robert Love .\" Copyright (C) 2005 Robert Love
.\" .\"
.TH NM-TOOL "1" .TH NM-TOOL "1"
.SH NAME .SH NAME
nm-tool \- utility to report NetworkManager state nm-tool \- utility to report NetworkManager state and devices
.SH SYNOPSIS .SH SYNOPSIS
.B nm-tool .B nm-tool
.SH DESCRIPTION .SH DESCRIPTION
...@@ -12,4 +14,4 @@ The \fInm-tool\fP utility provides information about NetworkManager, device, ...@@ -12,4 +14,4 @@ The \fInm-tool\fP utility provides information about NetworkManager, device,
and wireless networks. and wireless networks.
.SH SEE ALSO .SH SEE ALSO
.BR NetworkManager (8), .BR NetworkManager (8),
.BR NetworkManagerDispatcher (8)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment