xref: /freebsd/sbin/dhclient/dhclient.leases.5 (revision d93a896ef95946b0bf1219866fcb324b78543444)
1.\"	$OpenBSD: dhclient.leases.5,v 1.4 2004/04/15 08:59:47 jmc Exp $
2.\"
3.\" Copyright (c) 1997 The Internet Software Consortium.
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\"
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. Neither the name of The Internet Software Consortium nor the names
16.\"    of its contributors may be used to endorse or promote products derived
17.\"    from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE INTERNET SOFTWARE CONSORTIUM AND
20.\" CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
21.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
22.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
23.\" DISCLAIMED.  IN NO EVENT SHALL THE INTERNET SOFTWARE CONSORTIUM OR
24.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
27.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
28.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
30.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31.\" SUCH DAMAGE.
32.\"
33.\" This software has been written for the Internet Software Consortium
34.\" by Ted Lemon <mellon@fugue.com> in cooperation with Vixie
35.\" Enterprises.  To learn more about the Internet Software Consortium,
36.\" see ``http://www.isc.org/isc''.  To learn more about Vixie
37.\" Enterprises, see ``http://www.vix.com''.
38.\"
39.\" $FreeBSD$
40.\"
41.Dd January 1, 1997
42.Dt DHCLIENT.LEASES 5
43.Os
44.Sh NAME
45.Nm dhclient.leases
46.Nd DHCP client lease database
47.Sh DESCRIPTION
48The Internet Software Consortium DHCP client keeps a persistent
49database of leases that it has acquired that are still valid.
50The database is a free-form ASCII file containing one valid declaration
51per lease.
52If more than one declaration appears for a given lease,
53the last one in the file is used.
54The file is written as a log, so this is not an unusual occurrence.
55.Pp
56The lease file is named
57.Pa dhclient.leases. Ns Ar IFNAME ,
58where
59.Ar IFNAME
60represents the network interface the DHCP client acquired the lease on.
61For example, if
62.Xr dhclient 8
63is configured for the
64.Li em0
65network device,
66the lease file will be named
67.Pa dhclient.leases.em0 .
68.Pp
69The format of the lease declarations is described in
70.Xr dhclient.conf 5 .
71.Sh FILES
72.Bl -tag -width ".Pa /var/db/dhclient.leases. Ns Ar IFNAME"
73.It Pa /var/db/dhclient.leases. Ns Ar IFNAME
74Current lease file.
75.El
76.Sh SEE ALSO
77.Xr dhclient.conf 5 ,
78.Xr dhcp-options 5 ,
79.Xr dhcpd.conf 5 ,
80.Xr dhclient 8 ,
81.Xr dhcpd 8
82.Rs
83.%R "RFC 2132, RFC 2131"
84.Re
85.Sh AUTHORS
86.An -nosplit
87The
88.Xr dhclient 8
89utility
90was written by
91.An Ted Lemon Aq Mt mellon@vix.com
92under a contract with Vixie Labs.
93.Pp
94The current implementation was reworked by
95.An Henning Brauer Aq Mt henning@openbsd.org .
96