Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Small improvements. Sort options. From jmc@openbsd.

This commit is contained in:
wiz 2005-10-31 15:28:53 +00:00
parent 25988cacf4
commit 14a2986cc2
1 changed files with 19 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
usr.sbin/rtadvd/rtadvd.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rtadvd.8,v 1.19 2003/09/07 16:22:27 wiz Exp $ .\" $NetBSD: rtadvd.8,v 1.20 2005/10/31 15:28:53 wiz Exp $
.\" $KAME: rtadvd.8,v 1.18 2002/04/28 10:43:02 jinmei Exp $ .\" $KAME: rtadvd.8,v 1.18 2002/04/28 10:43:02 jinmei Exp $
.\" .\"
.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
@ -28,7 +28,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd May 17, 1998 .Dd October 31, 2005
.Dt RTADVD 8 .Dt RTADVD 8
.Os .Os
.Sh NAME .Sh NAME
@ -36,13 +36,12 @@
.Nd router advertisement daemon .Nd router advertisement daemon
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Op Fl DdfMRs
.Op Fl c Ar configfile .Op Fl c Ar configfile
.Op Fl dDfMRs
.Ar interface ... .Ar interface ...
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
sends router advertisement packets to the specified sends router advertisement packets to the specified interfaces.
.Ar interfaces .
.Pp .Pp
The program will daemonize itself on invocation. The program will daemonize itself on invocation.
It will then send router advertisement packets periodically, as well It will then send router advertisement packets periodically, as well
@ -53,7 +52,7 @@ described in
.Xr rtadvd.conf 5 . .Xr rtadvd.conf 5 .
.Pp .Pp
If there is no configuration file entry for an interface, If there is no configuration file entry for an interface,
or if the configuration file does not exist altogether, or if the configuration file does not exist at all,
.Nm .Nm
sets all the parameters to their default values. sets all the parameters to their default values.
In particular, In particular,
@ -83,23 +82,25 @@ However, it would sometimes be useful to allow hosts to advertise some
parameters such as prefix information and link MTU. parameters such as prefix information and link MTU.
Thus, Thus,
.Nm .Nm
can be invoked if router lifetime is explicitly set zero on every can be invoked if router lifetime is explicitly set to zero on every
advertising interface. advertising interface.
.Pp .Pp
The command line options are: The command line options are:
.Bl -tag -width indent .Bl -tag -width indent
.\" .\"
.It Fl c .It Fl c Ar configfile
Specify an alternate location, Specify an alternate location,
.Ar configfile , .Ar configfile ,
for the configuration file. for the configuration file.
By default, By default,
.Pa /etc/rtadvd.conf .Pa /etc/rtadvd.conf
is used. is used.
.It Fl D
Even more debugging information than that offered by the
.Fl d
option is printed.
.It Fl d .It Fl d
Print debugging information. Print debugging information.
.It Fl D
Even more debugging information is printed.
.It Fl f .It Fl f
Foreground mode (useful when debugging). Foreground mode (useful when debugging).
Log messages will be dumped to stderr when this option is specified. Log messages will be dumped to stderr when this option is specified.
@ -118,7 +119,9 @@ option, which enables routing renumbering protocol support.
.\"permitted configuration directives. .\"permitted configuration directives.
.It Fl R .It Fl R
Accept router renumbering requests. Accept router renumbering requests.
If you enable it, certain IPsec setup is suggested for security reasons. If you enable it, an
.Xr ipsec 4
setup is suggested for security reasons.
.\"On KAME-based systems, .\"On KAME-based systems,
.\".Xr rrenumd 8 .\".Xr rrenumd 8
.\"generates router renumbering request packets. .\"generates router renumbering request packets.
@ -147,16 +150,14 @@ will transmit router advertisement with router lifetime 0
to all the interfaces to all the interfaces
.Pq in accordance with RFC 2461 6.2.5 . .Pq in accordance with RFC 2461 6.2.5 .
.Sh EXIT STATUS .Sh EXIT STATUS
The .Ex -std rtadvd
.Nm
program exits 0 on success, and \*[Gt]0 on failures.
.Sh FILES .Sh FILES
.Bl -tag -width Pa -compact .Bl -tag -width /var/run/rtadvd.dumpXX -compact
.It Pa /etc/rtadvd.conf .It Pa /etc/rtadvd.conf
The default configuration file. The default configuration file.
.It Pa /var/run/rtadvd.pid .It Pa /var/run/rtadvd.pid
contains the pid of the currently running Contains the PID of the currently running
.Nm rtadvd . .Nm .
.It Pa /var/run/rtadvd.dump .It Pa /var/run/rtadvd.dump
The file in which The file in which
.Nm .Nm
@ -176,6 +177,6 @@ advertise Router Advertisement messages on an upstream link to avoid
undesirable undesirable
.Xr icmp6 4 .Xr icmp6 4
redirect messages. redirect messages.
However, based on the later discussion in the IETF IPng working group, However, based on later discussion in the IETF IPng working group,
all routers should rather advertise the messages regardless of all routers should rather advertise the messages regardless of
the network topology, in order to ensure reachability. the network topology, in order to ensure reachability.