NAME

       radvd - router advertisement daemon for IPv6

SYNOPSIS

       radvd  [  -hsvc ] [ -d debuglevel ] [ -C configfile ] [ -p pidfile ] [ -m logmethod ] [ -l logfile ] [ -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. They also can
       choose a default router based on these advertisements.

       Note that if debugging is not enabled, radvd will  not  start  if  IPv6  forwarding  is  disabled.   IPv6
       forwarding    can    be    controlled   via   sysctl(8),   net.ipv6.conf.all.forwarding   on   Linux   or
       net.inet6.ip6.forwarding on BSD.

       Similarly, 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.

       -s, --singleprocess
              On  Linux  if  username  is  specified,  privilege  separation  is  enabled  and there will be two
              processes.  This option disables privilege separation, and as a result, the  non-privileged  radvd
              process does not have permissions to change interface configuration.

       -c, --configtest
              Test configuration and do startup tests and then exit.

       -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 /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/sbin/radvd
       /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 Pekka Savola
       <pekkas@netcore.fi>.

SEE ALSO

       radvd.conf(5), radvdump(8)

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> - current 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>   - Many fixes and cleanups
       Pierre Ossman   <pierre@ossman.eu>      - RFC6106 (DNSSL) support

radvd 1.9.1                                        14 Dec 2010                                          RADVD(8)