radvd(8)

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 /etc/radvd.conf is used.

-p pidfile, --pidfile pidfile: Specifies an alternate pidfile. Normally the compiled in default /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/bin/radvd
/etc/radvd.conf
/run/radvd.pid
/var/log/radvd.log

BUGS

There certainly are some bugs. If you find them or have other suggestions please send to https://github.com/radvd-project/radvd/issues

AUTHORS

Pedro Roque	<[email protected]>	- wrote first version for Linux
Lars Fenneberg	<[email protected]>	- previous maintainer
Nathan Lutchansky	<[email protected]>	- previous maintainer
Pekka Savola   <[email protected]>     - previous maintainer
Craig Metz	<[email protected]>	- port to NRL's IPv6 code for BSD4.4
Marko Myllynen	<[email protected]>	- RFC 2461 update, Mobile IPv6 support
Jim Paris	<[email protected]>		- Privilege separation support
Reuben Hawkins  <[email protected]>   - previous maintainer
Pierre Ossman   <[email protected]>      - RFC6106 (DNSSL) support
Varka Bhadram 	<[email protected]> - 6LoWPAN-ND (RFC6775) support
Robin H. Johnson	<[email protected]>	- current maintainer, RA splitting per RFC 6980 & RFC4861#6.2.3
Radek Zajic	<[email protected]>	- NAT64 pref64 support (RFC8781)
Geert Stappers <[email protected]>   - contributor