111 lines
3.8 KiB
Plaintext
111 lines
3.8 KiB
Plaintext
.\" This manpage has been automatically generated by docbook2man
|
||
.\" from a DocBook document. This tool can be found at:
|
||
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
|
||
.\" Please send any bug reports, improvements, comments, patches,
|
||
.\" etc. to Steve Cheng <steve@ggi-project.org>.
|
||
.TH "RDISC" "8" "24 Mayıs 2011" "iputils-101006" "System Manager's Manual: iputils"
|
||
.SH NAME
|
||
rdisc \- network router discovery daemon
|
||
.SH SYNOPSIS
|
||
|
||
\fBrdisc\fR [ \fB-abdfstvV\fR] [ \fB\fIsend_address\fB\fR] [ \fB\fIreceive_address\fB\fR]
|
||
|
||
.SH "DESCRIPTION"
|
||
.PP
|
||
\fBrdisc\fR implements client side of the ICMP router discover protocol.
|
||
\fBrdisc\fR is invoked at boot time to populate the network
|
||
routing tables with default routes.
|
||
.PP
|
||
\fBrdisc\fR listens on the ALL_HOSTS (224.0.0.1) multicast address
|
||
(or \fIreceive_address\fR provided it is given)
|
||
for ROUTER_ADVERTISE messages from routers. The received
|
||
messages are handled by first ignoring those listed router addresses
|
||
with which the host does not share a network. Among the remaining addresses
|
||
the ones with the highest preference are selected as default routers
|
||
and a default route is entered in the kernel routing table
|
||
for each one of them.
|
||
.PP
|
||
Optionally, \fBrdisc\fR can avoid waiting for routers to announce
|
||
themselves by sending out a few ROUTER_SOLICITATION messages
|
||
to the ALL_ROUTERS (224.0.0.2) multicast address
|
||
(or \fIsend_address\fR provided it is given)
|
||
when it is started.
|
||
.PP
|
||
A timer is associated with each router address and the address will
|
||
no longer be considered for inclusion in the the routing tables if the
|
||
timer expires before a new
|
||
\fBadvertise\fR message is received from the router.
|
||
The address will also be excluded from consideration if the host receives an
|
||
\fBadvertise\fR
|
||
message with the preference being maximally negative.
|
||
.PP
|
||
Server side of router discovery protocol is supported by Cisco IOS
|
||
and by any more or less complete UNIX routing daemon, f.e \fBgated\fR.
|
||
.SH "OPTIONS"
|
||
.TP
|
||
\fB-a\fR
|
||
Accept all routers independently of the preference they have in their
|
||
\fBadvertise\fR messages.
|
||
Normally \fBrdisc\fR only accepts (and enters in the kernel routing
|
||
tables) the router or routers with the highest preference.
|
||
.TP
|
||
\fB-b\fR
|
||
Opposite to \fB-a\fR, i.e. install only router with the best
|
||
preference value. It is default behaviour.
|
||
.TP
|
||
\fB-d\fR
|
||
Send debugging messages to syslog.
|
||
.TP
|
||
\fB-f\fR
|
||
Run \fBrdisc\fR forever even if no routers are found.
|
||
Normally \fBrdisc\fR gives up if it has not received any
|
||
\fBadvertise\fR message after after soliciting three times,
|
||
in which case it exits with a non-zero exit code.
|
||
If \fB-f\fR is not specified in the first form then
|
||
\fB-s\fR must be specified.
|
||
.TP
|
||
\fB-s\fR
|
||
Send three \fBsolicitation\fR messages initially to quickly discover
|
||
the routers when the system is booted.
|
||
When \fB-s\fR is specified \fBrdisc\fR
|
||
exits with a non-zero exit code if it can not find any routers.
|
||
This can be overridden with the \fB-f\fR option.
|
||
.TP
|
||
\fB-t\fR
|
||
Test mode. Do not go to background.
|
||
.TP
|
||
\fB-v\fR
|
||
Be verbose i.e. send lots of debugging messages to syslog.
|
||
.TP
|
||
\fB-V\fR
|
||
Print version and exit.
|
||
.SH "HISTORY"
|
||
.PP
|
||
This program was developed by Sun Microsystems (see copyright
|
||
notice in source file). It was ported to Linux by
|
||
Alexey Kuznetsov
|
||
<kuznet@ms2.inr.ac.ru>.
|
||
It is now maintained by
|
||
YOSHIFUJI Hideaki
|
||
<yoshfuji@skbuff.net>.
|
||
.SH "SEE ALSO"
|
||
.PP
|
||
\fBicmp\fR(7),
|
||
\fBinet\fR(7),
|
||
\fBping\fR(8).
|
||
.SH "REFERENCES"
|
||
.PP
|
||
Deering, S.E.,ed "ICMP Router Discovery Messages",
|
||
RFC1256, Network Information Center, SRI International,
|
||
Menlo Park, Calif., September 1991.
|
||
.SH "SECURITY"
|
||
.PP
|
||
\fBrdisc\fR requires CAP_NET_RAWIO to listen
|
||
and send ICMP messages and capability CAP_NET_ADMIN
|
||
to update routing tables.
|
||
.SH "AVAILABILITY"
|
||
.PP
|
||
\fBrdisc\fR is part of \fIiputils\fR package
|
||
and the latest versions are available in source form at
|
||
http://www.skbuff.net/iputils/iputils-current.tar.bz2.
|