xref: /openbsd-src/usr.sbin/rad/rad.8 (revision 5207bb19fdf2419f8984bb748973c0acc19b5ded)
1.\"	$OpenBSD: rad.8,v 1.7 2022/10/15 13:26:15 florian Exp $
2.\"
3.\" Copyright (c) 2018 Florian Obser <florian@openbsd.org>
4.\" Copyright (c) 2016 Kenneth R Westerback <kwesterback@gmail.com>
5.\"
6.\" Permission to use, copy, modify, and distribute this software for any
7.\" purpose with or without fee is hereby granted, provided that the above
8.\" copyright notice and this permission notice appear in all copies.
9.\"
10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17.\"
18.Dd $Mdocdate: October 15 2022 $
19.Dt RAD 8
20.Os
21.Sh NAME
22.Nm rad
23.Nd router advertisement daemon
24.Sh SYNOPSIS
25.Nm
26.Op Fl dnv
27.Op Fl f Ar file
28.Op Fl s Ar socket
29.Sh DESCRIPTION
30.Nm
31is an IPv6 router advertisement daemon.
32It periodically sends IPv6 router advertisement messages with prefix
33and default router information.
34Clients like
35.Xr slaacd 8
36use these to configure IPv6 addresses on network interfaces and set default
37routes.
38Additionally it listens for IPv6 router solicitation messages and responds
39with router advertisements.
40.Pp
41To have
42.Nm
43enabled at boot time, use
44.Dq rcctl enable rad ,
45which sets
46.Pp
47.Dl rad_flags=\(dq\(dq
48.Pp
49in
50.Xr rc.conf.local 8 .
51.Pp
52A running
53.Nm
54can be controlled with the
55.Xr ractl 8
56utility.
57.Pp
58The options are as follows:
59.Bl -tag -width Ds
60.It Fl d
61Do not daemonize.
62If this option is specified,
63.Nm
64will run in the foreground and log to
65.Em stderr .
66.It Fl f Ar file
67Specify an alternative configuration file.
68.It Fl n
69Configtest mode.
70Only check the configuration file for validity.
71.It Fl s Ar socket
72Use an alternate location for the default control socket.
73.It Fl v
74Produce more verbose output.
75.El
76.Sh FILES
77.Bl -tag -width "/var/run/rad.sockXX" -compact
78.It Pa /etc/rad.conf
79Default
80.Nm
81configuration file.
82.It Pa /var/run/rad.sock
83.Ux Ns -domain
84socket used for communication with
85.Xr ractl 8 .
86.El
87.Sh SEE ALSO
88.Xr rad.conf 5 ,
89.Xr ractl 8 ,
90.Xr slaacd 8
91.Sh STANDARDS
92.Rs
93.%A R. Draves
94.%A D. Thaler
95.%D November 2005
96.%R RFC 4191
97.%T Default Router Preferences and More-Specific Routes
98.Re
99.Pp
100.Rs
101.%A R. Hinden
102.%A S. Deering
103.%D February 2006
104.%R RFC 4291
105.%T IP Version 6 Addressing Architecture
106.Re
107.Pp
108.Rs
109.%A T. Narten
110.%A E. Nordmark
111.%A W. Simpson
112.%A H. Soliman
113.%D September 2007
114.%R RFC 4861
115.%T Neighbor Discovery for IP version 6 (IPv6)
116.Re
117.Pp
118.Rs
119.%A A. Yourtchenko
120.%A L. Colitti
121.%D February 2016
122.%R RFC 7772
123.%T Reducing Energy Consumption of Router Advertisements
124.Re
125.Pp
126.Rs
127.%A J. Jeong
128.%A S. Park
129.%A L. Beloeil
130.%A S. Madanapalli
131.%D March 2017
132.%R RFC 8106
133.%T IPv6 Router Advertisement Options for DNS Configuration
134.Re
135.Pp
136.Rs
137.%A L. Colitti
138.%A J. Linkova
139.%D April 2020
140.%R RFC 8781
141.%T Discovering PREF64 in Router Advertisements
142.Re
143.Sh HISTORY
144The
145.Nm
146program first appeared in
147.Ox 6.4 .
148.Sh AUTHORS
149.An -nosplit
150The
151.Nm
152program was written by
153.An Florian Obser Aq Mt florian@openbsd.org .
154