xref: /openbsd/sbin/slaacd/slaacd.8 (revision 3bef86f7)
1.\"	$OpenBSD: slaacd.8,v 1.12 2023/03/02 17:09:54 jmc Exp $
2.\"
3.\" Copyright (c) 2017 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: March 2 2023 $
19.Dt SLAACD 8
20.Os
21.Sh NAME
22.Nm slaacd
23.Nd Stateless Address Autoconfiguration (SLAAC) daemon
24.Sh SYNOPSIS
25.Nm
26.Op Fl dv
27.Op Fl s Ar socket
28.Sh DESCRIPTION
29.Nm
30is a stateless address autoconfiguration (SLAAC) daemon for clients.
31It listens for IPv6 router advertisement messages,
32for example those sent by
33.Xr rad 8 ,
34on interfaces with the
35.Sy AUTOCONF6
36flag set.
37.Nm
38derives IPv6 addresses and default routes from received router
39advertisements and installs them in the kernel.
40See
41.Xr hostname.if 5
42and
43.Xr ifconfig 8
44on how to enable auto configuration on an interface.
45.Pp
46.Nm
47monitors network interface states (interface going up or down,
48auto configuration enabled or disabled etc.) and sends router solicitations
49when necessary.
50.Pp
51A running
52.Nm
53can be controlled with the
54.Xr slaacctl 8
55utility.
56.Pp
57The options are as follows:
58.Bl -tag -width Ds
59.It Fl d
60Do not daemonize.
61If this option is specified,
62.Nm
63will run in the foreground and log to
64.Em stderr .
65.It Fl s Ar socket
66Use an alternate location for the default control socket.
67.It Fl v
68Produce more verbose output.
69Multiple
70.Fl v
71options increase the verbosity.
72.El
73.Sh FILES
74.Bl -tag -width "/dev/slaacd.sockXX" -compact
75.It Pa /dev/slaacd.sock
76.Ux Ns -domain
77socket used for communication with
78.Xr slaacctl 8 .
79.El
80.Sh SEE ALSO
81.Xr hostname.if 5 ,
82.Xr ifconfig 8 ,
83.Xr rad 8 ,
84.Xr slaacctl 8
85.Sh STANDARDS
86.Rs
87.%A R. Draves
88.%A D. Thaler
89.%D November 2005
90.%R RFC 4191
91.%T Default Router Preferences and More-Specific Routes
92.Re
93.Pp
94.Rs
95.%A R. Hinden
96.%A S. Deering
97.%D February 2006
98.%R RFC 4291
99.%T IP Version 6 Addressing Architecture
100.Re
101.Pp
102.Rs
103.%A T. Narten
104.%A E. Nordmark
105.%A W. Simpson
106.%A H. Soliman
107.%D September 2007
108.%R RFC 4861
109.%T Neighbor Discovery for IP version 6 (IPv6)
110.Re
111.Pp
112.Rs
113.%A F. Gont
114.%D April 2014
115.%R RFC 7217
116.%T A Method for Generating Semantically Opaque Interface Identifiers with IPv6 Stateless Address Autoconfiguration (SLAAC)
117.Re
118.Pp
119.Rs
120.%A A. Yourtchenko
121.%A L. Colitti
122.%D February 2016
123.%R RFC 7772
124.%T Reducing Energy Consumption of Router Advertisements
125.Re
126.Pp
127.Rs
128.%A F. Gont
129.%A A. Cooper
130.%A D. Thaler
131.%A W. Liu
132.%D February 2017
133.%R RFC 8064
134.%T Recommendation on Stable IPv6 Interface Identifiers
135.Re
136.Pp
137.Rs
138.%A J. Jeong
139.%A S. Park
140.%A L. Beloeil
141.%A S. Madanapalli
142.%D March 2017
143.%R RFC 8106
144.%T IPv6 Router Advertisement Options for DNS Configuration
145.Re
146.Pp
147.Rs
148.%A F. Gont
149.%A S. Krishnan
150.%A T. Narten
151.%A R. Draves
152.%D February 2021
153.%R RFC 8981
154.%T Temporary Address Extensions for Stateless Address Autoconfiguration in IPv6
155.Re
156.Sh HISTORY
157The
158.Nm
159program first appeared in
160.Ox 6.2 .
161.Sh AUTHORS
162.An -nosplit
163The
164.Nm
165program was written by
166.An Florian Obser Aq Mt florian@openbsd.org .
167