/
radvd.8.man
177 lines (166 loc) · 5.09 KB
/
radvd.8.man
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
.\"
.\"
.\" Authors:
.\" Lars Fenneberg <lf@elemental.net>
.\"
.\" This software is Copyright 1996-2000 by the above mentioned author(s),
.\" All Rights Reserved.
.\"
.\" The license which is distributed with this software in the file COPYRIGHT
.\" applies to this software. If your distribution is missing this file, you
.\" may request it from <reubenhwk@gmail.com>.
.\"
.\"
.\"
.TH RADVD 8 "14 Dec 2010" "radvd @VERSION@" ""
.SH NAME
radvd \- router advertisement daemon for IPv6
.SH SYNOPSIS
.B radvd
.B "[ \-hsvc ]"
.BI "[ \-d " debuglevel " ]"
.BI "[ \-C " configfile " ]"
.BI "[ \-p " pidfile " ]"
.BI "[ \-m " logmethod " ]"
.BI "[ \-l " logfile " ]"
.BI "[ \-n " nodaemon " ]"
.BI "[ \-f " facility " ]"
.BI "[ \-t " chrootdir " ]"
.BI "[ \-u " username " ]"
.SH DESCRIPTION
.B radvd
is the router advertisement daemon for IPv6. It listens to router
solicitations and sends router advertisements as described in
"Neighbor Discovery for IP Version 6 (IPv6)" (RFC 4861).
With these advertisements hosts can automatically configure their
addresses and some other parameters. It also defines "Neighbor Discovery
Optimization for IPv6 over Low-Power Wireless Personal Area Networks (6LoWPANs)" (RFC6775).
They also can choose a default router based on these advertisements.
The configuration file must not be writable by others, and if
non-root operation is requested, not even by self/own group.
.SH OPTIONS
For every one character option there is also a long option, which
is listed right next to the "short" option name:
.TP
.BR "\-v" , " \-\-version"
Displays the version of
.I radvd
and then aborts.
.TP
.BR "\-h" , " \-\-help"
Displays a short usage description and then aborts.
.TP
.BR "\-c" , " \-\-configtest"
Test configuration and do startup tests and then exit.
.TP
.BR "\-n" , " \-\-nodaemon"
Prevent the daemonizing.
.TP
.BR "\-d " debuglevel, " \-\-debug " debuglevel
With this option you turn on debugging information. The debugging level is
an integer in the range from 1 to 5, from quiet to very verbose. A
debugging level of 0 completely turns off debugging. If a debugging level
greater than 0 is used,
.I radvd
doesn't background itself on start. The default debugging level is 0.
.TP
.BR "\-C " configfile, " \-\-config " configfile
Specifies an alternate config file. Normally the compiled in default
.I @PATH_RADVD_CONF@
is used.
.TP
.BR "\-p " pidfile, " \-\-pidfile " pidfile
Specifies an alternate pidfile. Normally the compiled in default
.I @PATH_RADVD_PID@
is used.
.TP
.BR "\-m " method, " \-\-logmethod " method
Specifies the logging method to use. Possibly values are:
.RS
.TP
.B none
Completely disables any logging.
.TP
.B logfile
Logs to the logfile which is specified by the
.I \-l
option. If no logfile is specified on the command line, then
a compiled in default is used (see next option).
.TP
.B stderr
Logs to standard error.
.TP
.B stderr_syslog
Logs only the high messages (of at least LOG_ERR priority) to standard
error, and everything to syslog (default method).
.TP
.B syslog
Logs to syslog.
.RE
.PP
.TP
.BR "\-l " logfile, " \-\-logfile " logfile
Specifies the logfile to use when using the logging method
.IR logfile .
The default logfile is
.IR @PATH_RADVD_LOG@ .
.TP
.BR "\-f " facility, " \-\-facility " facility
Specifies the facility (as an integer) when using syslog logging. Default
is @LOG_FACILITY@.
.TP
.BR "\-t " chrootdir, " \-\-chrootdir " chrootdir
If specified, switches to
.I chrootdir
before doing anything else. This directory and its
subdirectories must have been populated first.
For security reasons,
.I \-u
must always be used when using
.IR chrootdir .
Note that on Linux
.I radvd
requires access to the
.I /proc
filesystem,
so it is more challenging to set up the chroot environment.
.TP
.BR "\-u " username, " \-\-username " username
If specified, drops root privileges and changes user ID to
.I username
and group ID to the primary group of
.IR username .
This is recommended for security reasons.
You might also need to use
.I \-p
to point to a file in a
.I username
-writable directory (e.g. /var/run/radvd/radvd.pid).
.SH FILES
.nf
@sbindir@/radvd
@PATH_RADVD_CONF@
@PATH_RADVD_PID@
@PATH_RADVD_LOG@
.fi
.SH BUGS
There certainly are some bugs. If you find them or have other
suggestions please contact Reuben Hawkins <reubenhwk@gmail.com>.
.SH "SEE ALSO"
.BR radvd.conf (5),
.BR radvdump (8)
.SH AUTHORS
.nf
Pedro Roque <roque@di.fc.ul.pt> - wrote first version for Linux
Lars Fenneberg <lf@elemental.net> - previous maintainer
Nathan Lutchansky <lutchann@litech.org> - previous maintainer
Pekka Savola <pekkas@netcore.fi> - previous maintainer
Craig Metz <cmetz@inner.net> - port to NRL's IPv6 code for BSD4.4
Marko Myllynen <myllynen@lut.fi> - RFC 2461 update, Mobile IPv6 support
Jim Paris <jim@jtan.com> - Privilege separation support
Reuben Hawkins <reubenhwk@gmail.com> - current maintainer
Pierre Ossman <pierre@ossman.eu> - RFC6106 (DNSSL) support
Varka Bhadram <varkabhadram@gmail.com> - 6LoWPAN-ND (RFC6775) support
Robin H. Johnson <robbat2@gentoo.org> - RA splitting per RFC 6980 & RFC4861#6.2.3
Radek Zajic <radek@zajic.v.pytli.cz> - NAT64 pref64 support (RFC8781)
.fi