1RADVD(8)                                                              RADVD(8)
2
3
4

NAME

6       radvd - router advertisement daemon for IPv6
7

SYNOPSIS

9       radvd [ -hsvc ] [ -d debuglevel ] [ -C configfile ] [ -p pidfile ] [ -m
10       logmethod ] [ -l logfile ] [ -f facility ] [ -t chrootdir ] [ -u  user‐
11       name ]
12
13

DESCRIPTION

15       radvd is the router advertisement daemon for IPv6. It listens to router
16       solicitations and sends router advertisements as described in "Neighbor
17       Discovery  for  IP Version 6 (IPv6)" (RFC 4861).  With these advertise‐
18       ments hosts can automatically configure their addresses and some  other
19       parameters. They also can choose a default router based on these adver‐
20       tisements.
21
22       Note that if debugging is not enabled, radvd will  not  start  if  IPv6
23       forwarding   is  disabled.   IPv6  forwarding  can  be  controlled  via
24       sysctl(8), net.ipv6.conf.all.forwarding on Linux or  net.inet6.ip6.for‐
25       warding on BSD.
26
27       Similarly,  the  configuration file must not be writable by others, and
28       if non-root operation is requested, not even by self/own group.
29
30

OPTIONS

32       For every one character option there is also a long  option,  which  is
33       listed right next to the "short" option name:
34
35
36       -v, --version
37              Displays the version of radvd and then aborts.
38
39       -h, --help
40              Displays a short usage description and then aborts.
41
42       -s, --singleprocess
43              On  Linux  if  username  is  specified,  privilege separation is
44              enabled and there will be two processes.  This  option  disables
45              privilege  separation, and as a result, the non-privileged radvd
46              process does not have permissions to change interface configura‐
47              tion.
48
49       -c, --configtest
50              Test configuration and do startup tests and then exit.
51
52       -d debuglevel, --debug debuglevel
53              With  this  option you turn on debugging information. The debug‐
54              ging level is an integer in the range from 1 to 5,  from   quiet
55              to  very  verbose.  A  debugging level of 0 completely turns off
56              debugging. If a debugging level greater than 0  is  used,  radvd
57              doesn't  background itself on start. The default debugging level
58              is 0.
59
60       -C configfile, --config configfile
61              Specifies an alternate config file.  Normally  the  compiled  in
62              default /etc/radvd.conf is used.
63
64       -p pidfile, --pidfile pidfile
65              Specifies an alternate pidfile. Normally the compiled in default
66              /var/run/radvd/radvd.pid is used.
67
68       -m method, --logmethod method
69              Specifies the logging method to use. Possibly values are:
70
71              none   Completely disables any logging.
72
73              logfile
74                     Logs to the logfile which is specified by the -l  option.
75                     If  no  logfile  is specified on the command line, then a
76                     compiled in default is used (see next option).
77
78              stderr Logs to standard error.
79
80              stderr_syslog
81                     Logs only the high messages (of at least  LOG_ERR  prior‐
82                     ity) to standard error, and everything to syslog (default
83                     method).
84
85              syslog Logs to syslog.
86
87       -l logfile, --logfile logfile
88              Specifies the logfile to use when using the logging method  log‐
89              file.  The default logfile is /var/log/radvd.log.
90
91       -f facility, --facility facility
92              Specifies  the  facility  (as an integer) when using syslog log‐
93              ging. Default is LOG_DAEMON.
94
95       -t chrootdir, --chrootdir chrootdir
96              If specified, switches to chrootdir before doing anything  else.
97              This  directory  and its subdirectories must have been populated
98              first.  For security reasons, -u must always be used when  using
99              chrootdir.
100
101              Note  that  on Linux radvd requires access to the /proc filesys‐
102              tem, so it is more challenging to set up the chroot environment.
103
104       -u username, --username username
105              If specified, drops root privileges and changes user ID to user‐
106              name  and  group  ID  to the primary group of username.  This is
107              recommended for security reasons.  You might also need to use -p
108              to  point  to  a  file  in  a username -writable directory (e.g.
109              /var/run/radvd/radvd.pid).
110

FILES

112       /usr/sbin/radvd
113       /etc/radvd.conf
114       /var/run/radvd/radvd.pid
115       /var/log/radvd.log
116

BUGS

118       There certainly are some bugs. If you find them or have  other  sugges‐
119       tions please contact Pekka Savola <pekkas@netcore.fi>.
120
121

SEE ALSO

123       radvd.conf(5), radvdump(8)
124

AUTHORS

126       Pedro Roque    <roque@di.fc.ul.pt> - wrote first version for Linux
127       Lars Fenneberg <lf@elemental.net>  - previous maintainer
128       Nathan Lutchansky   <lutchann@litech.org>    - previous maintainer
129       Pekka Savola   <pekkas@netcore.fi> - current maintainer
130       Craig Metz     <cmetz@inner.net>   - port to NRL's IPv6 code for BSD4.4
131       Marko Myllynen <myllynen@lut.fi>   - RFC 2461 update, Mobile IPv6 support
132       Jim Paris <jim@jtan.com>      - Privilege separation support
133       Reuben Hawkins  <reubenhwk@gmail.com>   - Many fixes and cleanups
134       Pierre Ossman   <pierre@ossman.eu>      - RFC6106 (DNSSL) support
135
136
137
138radvd 1.8.2                       14 Dec 2010                         RADVD(8)
Impressum