NAME
rad.conf
—
router advertisement daemon
configuration file
DESCRIPTION
The rad(8) daemon is an IPv6 router advertisement daemon.
The rad.conf
config file is divided into
the following main sections:
- Macros
- User-defined variables may be defined and used later, simplifying the configuration file.
- Global Configuration
- Global settings for
rad(8). These are used as default values for
interface
definitions and can be overwritten in aninterface
block. - Interfaces
- rad(8) sends IPv6 router advertisement messages. This section defines on which interfaces to advertise prefix information and their associated parameters.
Additional configuration files can be included with the
include
keyword.
MACROS
Macros can be defined that will later be expanded in context.
Macro names must start with a letter, digit, or underscore, and may contain
any of those characters. Macro names may not be reserved words (for example,
interface
) Macros are not expanded inside
quotes.
GLOBAL CONFIGURATION
The global configuration section sets defaults for router advertisement messages. These can be overwritten in interface blocks.
default router
(yes
|no
)- Act as a default router or not. The default is yes.
dns
{dns options}dns
options are as follows:lifetime
seconds- The number of seconds the dns options are valid after receiving a router advertisement message. The default is 900 seconds.
nameserver
(IP|{ nameserver list })- IPv6 address or list of IPv6 addresses of DNS name servers.
search
(domain|{ domain list })- Domain or list of domains for the resolv.conf(5) search list.
hop limit
hops- Specify the diameter of the internet. The default is 0, meaning unspecified by this router.
managed address configuration
(yes
|no
)- If set to yes, indicate that stateless address configuration prefixes are not available and hosts should consult DHCPv6. The default is no.
mtu
bytes- The MTU option is used in Router Advertisement messages to ensure that all nodes on a link use the same MTU value in those cases where the link MTU is not well known. The default is 0, meaning unspecified by this router.
other configuration
(yes
|no
)- If set to yes, hosts should consult DHCPv6 for additional configuration like NTP servers or DNS name servers.
router lifetime
seconds- The number of seconds this router is a valid default router after receiving a router advertisement message. The default is 1800 seconds.
INTERFACES
A list of interfaces or interface groups to send advertisements on:
interface
name [{ prefix list }]
Options set in the global section can be overwritten inside an interface block. In addition an interface block can contain a list of prefixes:
[no
]auto prefix
[{ prefix options }]prefix
prefix [{ prefix options }]
The default is to discover prefixes to announce by inspecting the
IPv6 addresses configured on an interface. This can be disabled with
no auto prefix
. If prefix is
specified without prefixlen, its default is 64.
prefix
options are as follows:
autonomous address-configuration
(yes
|no
)- This prefix can be used to generate IPv6 addresses. The default is yes.
on-link
(yes
|no
)- This prefix is considered on-link. The default is yes.
preferred lifetime
seconds- The preferred lifetime (pltime) in seconds for addresses generated from this prefix. The default is 604800.
valid lifetime
seconds- The valid lifetime (vltime) in seconds for addresses generated from this prefix. The default is 2592000.
FILES
- /etc/rad.conf
- rad(8) configuration file
EXAMPLES
With the following example configuration,
rad.conf
will pick a prefix from the ix1 interface
and send router advertisements on it:
interface ix1
SEE ALSO
HISTORY
The rad.conf
file format first appeared in
OpenBSD 6.4.