mirror of
https://github.com/freebsd/freebsd-src.git
synced 2024-12-05 10:09:30 +00:00
223 lines
5.9 KiB
Groff
223 lines
5.9 KiB
Groff
.\" $KAME: rtsold.8,v 1.14 2000/08/13 18:06:39 itojun Exp $
|
|
.\"
|
|
.\" 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:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 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
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd May 17, 1998
|
|
.Dt RTSOLD 8
|
|
.Os KAME
|
|
.\"
|
|
.Sh NAME
|
|
.Nm rtsold
|
|
.Nd router solicitation daemon
|
|
.\"
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl dDfm1
|
|
.Ar interface ...
|
|
.Nm
|
|
.Op Fl dDfm1
|
|
.Fl a
|
|
.Nm rtsol
|
|
.Op Fl dD
|
|
.Ar interface ...
|
|
.Nm rtsol
|
|
.Op Fl dD
|
|
.Fl a
|
|
.\"
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is the daemon program to send ICMPv6 Router Solicitation messages
|
|
on the specified interfaces.
|
|
If a node (re)attaches to a link,
|
|
.Nm
|
|
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.
|
|
.Pp
|
|
.Nm
|
|
should be used on IPv6 host
|
|
.Pq non-router node
|
|
only.
|
|
.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
|
|
.Nm
|
|
daemon.
|
|
.It
|
|
The interface is up after a temporary interface failure.
|
|
.Nm
|
|
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 60 seconds if the
|
|
.Fl m
|
|
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 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 to another link.
|
|
.El
|
|
.Lp
|
|
Once
|
|
.Nm
|
|
sends a Router Solicitation, and receives a valid Router Advertisement,
|
|
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,
|
|
.Nm
|
|
includes a Source Link-layer address option if the interface
|
|
has its link-layer address.
|
|
.Pp
|
|
Upon receipt of signal
|
|
.Dv SIGUSR1 ,
|
|
.Nm
|
|
will dump the current internal state into
|
|
.Pa /var/run/rtsold.dump .
|
|
.\"
|
|
.Sh OPTIONS
|
|
.Bl -tag -width indent
|
|
.It Fl a
|
|
Autoprobe outgoing interface.
|
|
.Nm
|
|
will try to find a non-loopback, non-p2p and IPv6-capable, interface.
|
|
If
|
|
.Nm
|
|
finds multiple interfaces,
|
|
.Nm
|
|
will exit with error.
|
|
.\"
|
|
.It Fl d
|
|
Enable debugging.
|
|
.It Fl D
|
|
Enable more debugging including to print internal timer information.
|
|
.It Fl f
|
|
.Fl f
|
|
prevents
|
|
.Nm
|
|
from becoming a daemon (foreground mode).
|
|
Warning messages are generated to standard error output,
|
|
instead of
|
|
.Xr syslog 3 .
|
|
.It Fl m
|
|
Enable mobility support.
|
|
If this option is specified,
|
|
.Nm
|
|
sends probing packets to default routers that have advertised Router
|
|
Advertisements
|
|
when the node (re)attaches to an interface.
|
|
Moreover, if the option is specified,
|
|
.Nm
|
|
periodically sends Router Solicitation on an interface that does not support
|
|
.Dv SIOCGIFMEDIA
|
|
ioctl.
|
|
.It Fl 1
|
|
Perform only one probe.
|
|
Transmit Router Solicitation packet until valid Router Advertisement packet
|
|
arrives all the interfaces more than once, then exit.
|
|
.El
|
|
.Sh RETURN VALUES
|
|
The program exits with 0 on success, non-zero on failures.
|
|
.\"
|
|
.Sh FILES
|
|
.Bl -tag -width /var/run/rtsold.dump -compact
|
|
.It Pa /var/run/rtsold.pid
|
|
the pid of the currently running
|
|
.Nm .
|
|
.It Pa /var/run/rtsold.dump
|
|
dumps internal state on.
|
|
.El
|
|
.\"
|
|
.Sh SEE ALSO
|
|
.Xr rtadvd 8 ,
|
|
.Xr sysctl 8
|
|
.\"
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
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
|
|
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.
|
|
.Pp
|
|
IPv6 autoconfiguration specification assumes single interface host.
|
|
You may see kernel error message if you try to autoconfigure a host with
|
|
multiple interfaces.
|
|
Also, it seems contradictory for
|
|
.Nm
|
|
to accept multiple
|
|
.Ar interfaces
|
|
in argument.
|