radvd(8)

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

NAME

6       radvd - router advertisement daemon for IPv6
7

SYNOPSIS

9       radvd  [ -hsv ] [ -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       -d debuglevel, --debug debuglevel
50              With  this  option you turn on debugging information. The debug‐
51              ging level is an integer in the range from 1 to 5,  from   quiet
52              to  very  verbose.  A  debugging level of 0 completely turns off
53              debugging. If a debugging level greater than 0  is  used,  radvd
54              doesn't  background itself on start. The default debugging level
55              is 0.
56
57       -C configfile, --config configfile
58              Specifies an alternate config file.  Normally  the  compiled  in
59              default /etc/radvd.conf is used.
60
61       -p pidfile, --pidfile pidfile
62              Specifies an alternate pidfile. Normally the compiled in default
63              /var/run/radvd/radvd.pid is used.
64
65       -m method, --logmethod method
66              Specifies the logging method to use. Possibly values are:
67
68              none   Completely disables any logging.
69
70              logfile
71                     Logs to the logfile which is specified by the -l  option.
72                     If  no  logfile  is specified on the command line, then a
73                     compiled in default is used (see next option).
74
75              stderr Logs to standard error.
76
77              stderr_syslog
78                     Logs only the high messages (of at least  LOG_ERR  prior‐
79                     ity) to standard error, and everything to syslog (default
80                     method).
81
82              syslog Logs to syslog.
83
84       -l logfile, --logfile logfile
85              Specifies the logfile to use when using the logging method  log‐
86              file.  The default logfile is /var/log/radvd.log.
87
88       -f facility, --facility facility
89              Specifies  the  facility  (as an integer) when using syslog log‐
90              ging. Default is LOG_DAEMON.
91
92       -t chrootdir, --chrootdir chrootdir
93              If specified, switches to chrootdir before doing anything  else.
94              This  directory  and its subdirectories must have been populated
95              first.  For security reasons, -u must always be used when  using
96              chrootdir.
97
98              Note  that  on Linux radvd requires access to the /proc filesys‐
99              tem, so it is more challenging to set up the chroot environment.
100
101       -u username, --username username
102              If specified, drops root privileges and changes user ID to user‐
103              name  and  group  ID  to the primary group of username.  This is
104              recommended for security reasons.  You might also need to use -p
105              to  point  to  a  file  in  a username -writable directory (e.g.
106              /var/run/radvd/radvd.pid).
107

FILES

109       /usr/sbin/radvd
110       /etc/radvd.conf
111       /var/run/radvd/radvd.pid
112       /var/log/radvd.log
113

BUGS

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

AUTHORS

123       Pedro Roque    <roque@di.fc.ul.pt> - wrote first version for Linux
124       Lars Fenneberg <lf@elemental.net>  - previous maintainer
125       Nathan Lutchansky   <lutchann@litech.org>    - previous maintainer
126       Pekka Savola   <pekkas@netcore.fi> - current maintainer
127       Craig Metz     <cmetz@inner.net>   - port to NRL's IPv6 code for BSD4.4
128       Marko Myllynen <myllynen@lut.fi>   - RFC 2461 update, Mobile IPv6 support
129       Jim Paris <jim@jtan.com>      - Privilege separation support
130
131
132
133radvd 1.6                         24 Jan 2008                         RADVD(8)