Sync with latest KAME.

Obtained from:	KAME

1 files changed, 45 insertions, 28 deletions

diff --git a/usr.sbin/rtsold/rtsold.8 b/usr.sbin/rtsold/rtsold.8
index 90d483a..d1a50b1 100644
--- a/usr.sbin/rtsold/rtsold.8
+++ b/usr.sbin/rtsold/rtsold.8
@@ -1,6 +1,6 @@
 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
 .\" All rights reserved.
-.\"
+.\" 
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -12,7 +12,7 @@
 .\" 3. Neither the name of the project nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
-.\"
+.\" 
 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     $Id: rtsold.8,v 1.4 1999/09/30 00:57:15 jinmei Exp $
+.\"     $Id: rtsold.8,v 1.9 2000/07/04 14:44:38 jinmei Exp $
 .\"	$FreeBSD$
 .\"
 .Dd May 17, 1998
@@ -53,11 +53,26 @@ If a node (re)attaches to a link,
 sends some Router Solicitations on the link destined to the link-local scope
 all-routers multicast address to discover new routers
 and to get non link-local addresses.
-.Lp
+.Pp
+If you invoke the program as
+.Nm rtsol ,
+it will transmit probes from the specified
+.Ar interface ,
+without becoming a daemon.
+In other words,
+.Nm rtsol
+behaves as
+.Do
+.Nm
+.Fl f1
+.Ar interfaces
+.Dc .
+.Pp
 Specifically,
 .Nm
 sends at most 3 Router Solicitations on an interface
 after one of the following events:
+.Pp
 .Bl -bullet -compact
 .It
 Just after invocation of
@@ -66,32 +81,32 @@ daemon.
 .It
 The interface is up after a temporary interface failure.
 .Nm Rtsold
-detects it by periodically probing if the status of the
-interface is active or not.
-Note that some network cards and drivers do not allow users
-to extract link state.
+detects such failures by periodically probing to see if the status
+of the interface is active or not.
+Note that some network cards and drivers do not allow the extraction
+of link state.
 In such cases,
 .Nm
 cannot detect the change of the interface status.
 .It
-Every one minute if
+Every 60 seconds if the
 .Fl m
-option is specified and
+option is specified and the
 .Nm
 daemon cannot get the interface status.
 This feature does not conform to IPv6 neighbor discovery
 specification, but is provided for mobile stations.
-Default interval of router advertisements, which is on the order of 10
+Default interval for router advertisements, which is on the order of 10
 minutes, is slightly long for mobile stations.
 This feature is provided
 for such stations so that they can find new routers as soon as possible
-when they attach another link.
+when they attach to another link.
 .El
 .Lp
 Once
 .Nm
 sends a Router Solicitation, and receives a valid Router Advertisement,
-it desists from sending additional solicitations on that interface, until
+it refrains from sending additional solicitations on that interface, until
 the next time one of the above events occurs.
 .Lp
 When sending a Router Solicitation on an interface,
@@ -103,7 +118,7 @@ Upon receipt of signal
 .Dv SIGUSR1 ,
 .Nm
 will dump the current internal state into
-.Pa /var/tmp/rtsold.dump.
+.Pa /var/run/rtsold.dump.
 .\"
 .Sh OPTIONS
 .Bl -tag -width indent
@@ -134,18 +149,9 @@ periodically sends Router Solicitation on an interface that does not support
 ioctl.
 .It Fl 1
 Perform only one probe.
-Transmit Router Solcitation packet until valid Router Advertisement packet
+Transmit Router Solicitation packet until valid Router Advertisement packet
 arrives all the interfaces more than once, then exit.
 .El
-.Pp
-If you invoke the program as
-.Nm rtsol ,
-it will behave as
-.Do
-.Nm
-.Fl f1
-.Ar interfaces
-.Dc .
 .Sh RETURN VALUES
 The program exits with 0 on success, non-zero on failures.
 .\"
@@ -154,7 +160,7 @@ The program exits with 0 on success, non-zero on failures.
 .It Pa /var/run/rtsold.pid
 the pid of the currently running
 .Nm rtsold .
-.It Pa /var/tmp/rtsold.dump
+.It Pa /var/run/rtsold.dump
 dumps internal state on.
 .El
 .\"
@@ -165,11 +171,22 @@ dumps internal state on.
 .Sh HISTORY
 The
 .Nm
-command is based on
+command is based on the
 .Nm rtsol
 command, which first appeared in WIDE/KAME IPv6 protocol stack kit.
 .Nm rtsol
 is now integrated into
 .Xr rtsold 8 .
-.\" .Sh BUGS
-.\" (to be written)
+.\"
+.Sh BUGS
+In some operating systems, when a PCMCIA network card is removed
+and reinserted, the corresponding interface index is changed.
+However,
+.Nm
+does not assume such changes, and always uses the index that
+it got at invocation. As a result,
+.Nm
+may not work if you reinsert a network card.
+In such a case,
+.Nm
+should be killed and restarted.