xref: /openbsd-src/sbin/slaacd/slaacd.8 (revision fb6793a638ba2c194401d3a26cc78c1d73e6f504)
1.\"	$OpenBSD: slaacd.8,v 1.13 2024/08/11 06:07:37 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: August 11 2024 $
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.
31If an interface has the
32.Sy AUTOCONF6
33flag set
34(auto configuration is enabled),
35.Nm
36regularly sends out requests for IPv6 router advertisement messages,
37such as those sent by
38.Xr rad 8 ,
39and uses those messages to configure the relevant interface.
40.Pp
41See
42.Xr hostname.if 5
43and
44.Xr ifconfig 8
45on how to enable auto configuration on an interface.
46.Pp
47.Nm
48monitors network interface states
49(interface going up or down, auto configuration enabled or disabled, etc.)\&
50and sends router solicitations when necessary.
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