NAME

radvd - router advertisement daemon for IPv6

SYNOPSIS

radvd [ -hsvc ] [ -d debuglevel ] [ -C configfile ] [ -p pidfile ] [ -m logmethod ] [ -l logfile ] [ -n nodaemon ] [ -f facility ] [ -t chrootdir ] [ -u username ]

DESCRIPTION

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.

OPTIONS

For every one character option there is also a long option, which is listed right next to the "short" option name:

-v, --version: Displays the version of radvd and then aborts.
-h, --help: Displays a short usage description and then aborts.
-c, --configtest: Test configuration and do startup tests and then exit.
-n, --nodaemon: Prevent the daemonizing.
-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, radvd doesn't background itself on start. The default debugging level is 0.
-C configfile, --config configfile: Specifies an alternate config file. Normally the compiled in default /usr/local/etc/radvd.conf is used.
-p pidfile, --pidfile pidfile: Specifies an alternate pidfile. Normally the compiled in default /var/run/radvd.pid is used.
-m method, --logmethod method: Specifies the logging method to use. Possibly values are:

none: Completely disables any logging.
logfile: Logs to the logfile which is specified by the -l option. If no logfile is specified on the command line, then a compiled in default is used (see next option).
stderr: Logs to standard error.
stderr_syslog: Logs only the high messages (of at least LOG_ERR priority) to standard error, and everything to syslog (default method).
syslog: Logs to syslog.

-l logfile, --logfile logfile: Specifies the logfile to use when using the logging method logfile. The default logfile is /var/log/radvd.log.
-f facility, --facility facility: Specifies the facility (as an integer) when using syslog logging. Default is LOG_DAEMON.
-t chrootdir, --chrootdir chrootdir: If specified, switches to chrootdir before doing anything else. This directory and its subdirectories must have been populated first. For security reasons, -u must always be used when using chrootdir.
Note that on Linux radvd requires access to the /proc filesystem, so it is more challenging to set up the chroot environment.
-u username, --username username: If specified, drops root privileges and changes user ID to username and group ID to the primary group of username. This is recommended for security reasons. You might also need to use -p to point to a file in a username -writable directory (e.g. /var/run/radvd/radvd.pid).

FILES

/usr/local/sbin/radvd
/usr/local/etc/radvd.conf
/var/run/radvd.pid
/var/log/radvd.log

BUGS

There certainly are some bugs. If you find them or have other suggestions please contact Reuben Hawkins <reubenhwk@gmail.com>.

AUTHORS

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