1.\" $OpenBSD: dhcpleased.8,v 1.4 2021/08/23 18:09:05 florian Exp $ 2.\" 3.\" Copyright (c) 2021 Florian Obser <florian@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: August 23 2021 $ 18.Dt DHCPLEASED 8 19.Os 20.Sh NAME 21.Nm dhcpleased 22.Nd a dynamic host configuration protocol daemon 23.Sh SYNOPSIS 24.Nm 25.Op Fl dnv 26.Op Fl f Ar file 27.Op Fl s Ar socket 28.Sh DESCRIPTION 29.Nm 30is a dynamic host configuration protocol (DHCP) daemon for clients. 31It requests IP configuration information from for example those offered by 32.Xr dhcpd 8 , 33on interfaces with the 34.Sy AUTOCONF4 35flag set. 36See 37.Xr hostname.if 5 38and 39.Xr ifconfig 8 40on how to enable auto configuration on an interface. 41.Pp 42.Nm 43monitors network interface states (interface going up or down, 44auto configuration enabled or disabled etc.) and sends requests 45when necessary. 46.Pp 47A running 48.Nm 49can be controlled with the 50.Xr dhcpleasectl 8 51utility. 52.Pp 53The options are as follows: 54.Bl -tag -width Ds 55.It Fl d 56Do not daemonize. 57If this option is specified, 58.Nm 59will run in the foreground and log to 60.Em stderr . 61.It Fl f Ar file 62Specify an alternative configuration file. 63.It Fl n 64Configtest mode. 65Only check the configuration file for validity. 66.It Fl s Ar socket 67Use an alternate location for the default control socket. 68.It Fl v 69Produce more verbose output. 70Multiple 71.Fl v 72options increase the verbosity. 73.El 74.Sh FILES 75.Bl -tag -width "/dev/dhcpleased.sockXX" -compact 76.It Pa /dev/dhcpleased.sock 77.Ux Ns -domain 78socket used for communication with 79.Xr dhcpleasectl 8 . 80.It Pa /etc/dhcpleased.conf 81Default 82.Nm 83configuration file. 84.El 85.Sh SEE ALSO 86.Xr dhcpleased.conf 5 , 87.Xr hostname.if 5 , 88.Xr dhcpd 8 , 89.Xr dhcpleasectl 8 , 90.Xr ifconfig 8 91.Sh STANDARDS 92.Rs 93.%A R. Droms 94.%D March 1997 95.%R RFC 2131 96.%T Dynamic Host Configuration Protocol 97.Re 98.Pp 99.Rs 100.%A S. Alexander 101.%A R. Droms 102.%D March 1997 103.%R RFC 2132 104.%T DHCP Options and BOOTP Vendor Extensions 105.Re 106.Sh HISTORY 107The 108.Nm 109program first appeared in 110.Ox 6.9 . 111.Sh AUTHORS 112.An -nosplit 113The 114.Nm 115program was written by 116.An Florian Obser Aq Mt florian@openbsd.org . 117