File: rdisc6.8

package info (click to toggle)
ndisc6 0.7.3-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 664 kB
  • ctags: 179
  • sloc: ansic: 2,407; sh: 865; makefile: 115; perl: 37
file content (90 lines) | stat: -rw-r--r-- 3,337 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.\" ***********************************************************************
.\" *  Copyright © 2004-2006 Rémi Denis-Courmont.                         *
.\" *  This program is free software; you can redistribute and/or modify  *
.\" *  it under the terms of the GNU General Public License as published  *
.\" *  by the Free Software Foundation; version 2 of the license.         *
.\" *                                                                     *
.\" *  This program is distributed in the hope that it will be useful,    *
.\" *  but WITHOUT ANY WARRANTY; without even the implied warranty of     *
.\" *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               *
.\" *  See the GNU General Public License for more details.               *
.\" *                                                                     *
.\" *  You should have received a copy of the GNU General Public License  *
.\" *  along with this program; if not, you can get it from:              *
.\" *  http://www.gnu.org/copyleft/gpl.html                               *
.\" ***********************************************************************
.TH "RDISC6" "8" "$Date: 2006-06-03 21:06:19 +0300 (sam, 03 jun 2006) $" "rdisc6" "System Manager's Manual"
.SH NAME
rdisc \- ICMPv6 Router Discovery tool
.SH SYNOPSIS
.BR "rdisc6" " [" "-qv" "] [" "-r attempts" "] [" "-w wait_ms" "] ["
.BR "IPv6 address" "] <" "iface" ">"

.SH DESCRIPTON
.B RDisc6
is an Unix program which implements the ICMPv6 Router Discovery in
userland (it is normally done by the kernel). It is used to lookup the
list of on-link routers and IPv6 prefixes.

It can also be used to force the kernel to update the state of a given
IPv6-autoconfigured network interface.

The name of the network interface to probe routers for must be
specified.

.SH OPTIONS

.TP
.BR "\-1" " or " "\-\-single"
Exit as soon as the first advertisement is received.

.TP
.BR "\-h" " or " "\-\-help"
Display some help and exit.

.TP
.BR "\-m" " or " "\-\-multiple"
Wait for possible multiple advertisements and print all of them (default).

.TP
.BR "\-n" " or " "\-\-numeric"
If the optional parameter is not a valid IPv6 address, do not try to
resolve it as a DNS hostname.

.TP
.BR "\-q" " or " "\-\-quiet"
Only display advertised IPv6 prefixes. Display nothing in case of failure.
That is mostly useful when calling the program from a shell script.

.TP
.BR "\-r attempts" " or " "\-\-retry attempts"
Send ICMPv6 Router Discovery that many times until a reply is
received, or abort. By default, rdisc6 will try 3 times before aborting.

.TP
.BR "\-V" " or " "\-\-version"
Display program version and license and exit.

.TP
.BR "\-v" " or " "\-\-verbose"
Display verbose information. That is the default.

.TP
.BR "\-w wait_ms" " or " "\-\-wait wait_ms"
.RI "Wait " "wait_ms" " milliseconds for a response before retrying."
By default, rdisc6 waits 1 second between each attempts.

.SH SECURITY
.RI "rdisc6 must be " "setuid" " " "root" " to allow use by non "
privileged users. It will drop its root privileges before any attempt
is made to send or receive data from the network to reduce the possible
impact of a security vulnerability.

.SH "SEE ALSO"
ndisc6(8), ipv6(7)

.SH AUTHOR
R\[char233]mi Denis-Courmont <rdenis at simphalempin.com>

$Id: rdisc6.8 215 2006-06-03 18:06:19Z remi $