xref: /freebsd/sbin/dhclient/dhclient.leases.5 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
147c08596SBrooks Davis.\"	$OpenBSD: dhclient.leases.5,v 1.4 2004/04/15 08:59:47 jmc Exp $
247c08596SBrooks Davis.\"
347c08596SBrooks Davis.\" Copyright (c) 1997 The Internet Software Consortium.
447c08596SBrooks Davis.\" All rights reserved.
547c08596SBrooks Davis.\"
647c08596SBrooks Davis.\" Redistribution and use in source and binary forms, with or without
747c08596SBrooks Davis.\" modification, are permitted provided that the following conditions
847c08596SBrooks Davis.\" are met:
947c08596SBrooks Davis.\"
1047c08596SBrooks Davis.\" 1. Redistributions of source code must retain the above copyright
1147c08596SBrooks Davis.\"    notice, this list of conditions and the following disclaimer.
1247c08596SBrooks Davis.\" 2. Redistributions in binary form must reproduce the above copyright
1347c08596SBrooks Davis.\"    notice, this list of conditions and the following disclaimer in the
1447c08596SBrooks Davis.\"    documentation and/or other materials provided with the distribution.
1547c08596SBrooks Davis.\" 3. Neither the name of The Internet Software Consortium nor the names
1647c08596SBrooks Davis.\"    of its contributors may be used to endorse or promote products derived
1747c08596SBrooks Davis.\"    from this software without specific prior written permission.
1847c08596SBrooks Davis.\"
1947c08596SBrooks Davis.\" THIS SOFTWARE IS PROVIDED BY THE INTERNET SOFTWARE CONSORTIUM AND
2047c08596SBrooks Davis.\" CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
2147c08596SBrooks Davis.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
2247c08596SBrooks Davis.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2347c08596SBrooks Davis.\" DISCLAIMED.  IN NO EVENT SHALL THE INTERNET SOFTWARE CONSORTIUM OR
2447c08596SBrooks Davis.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
2547c08596SBrooks Davis.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
2647c08596SBrooks Davis.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
2747c08596SBrooks Davis.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
2847c08596SBrooks Davis.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
2947c08596SBrooks Davis.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
3047c08596SBrooks Davis.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3147c08596SBrooks Davis.\" SUCH DAMAGE.
3247c08596SBrooks Davis.\"
3347c08596SBrooks Davis.\" This software has been written for the Internet Software Consortium
3447c08596SBrooks Davis.\" by Ted Lemon <mellon@fugue.com> in cooperation with Vixie
3547c08596SBrooks Davis.\" Enterprises.  To learn more about the Internet Software Consortium,
3647c08596SBrooks Davis.\" see ``http://www.isc.org/isc''.  To learn more about Vixie
3747c08596SBrooks Davis.\" Enterprises, see ``http://www.vix.com''.
3847c08596SBrooks Davis.\"
3947c08596SBrooks Davis.Dd January 1, 1997
4047c08596SBrooks Davis.Dt DHCLIENT.LEASES 5
4147c08596SBrooks Davis.Os
4247c08596SBrooks Davis.Sh NAME
4347c08596SBrooks Davis.Nm dhclient.leases
4447c08596SBrooks Davis.Nd DHCP client lease database
4547c08596SBrooks Davis.Sh DESCRIPTION
4647c08596SBrooks DavisThe Internet Software Consortium DHCP client keeps a persistent
4747c08596SBrooks Davisdatabase of leases that it has acquired that are still valid.
4847c08596SBrooks DavisThe database is a free-form ASCII file containing one valid declaration
4947c08596SBrooks Davisper lease.
5047c08596SBrooks DavisIf more than one declaration appears for a given lease,
5147c08596SBrooks Davisthe last one in the file is used.
5247c08596SBrooks DavisThe file is written as a log, so this is not an unusual occurrence.
5347c08596SBrooks Davis.Pp
5447c08596SBrooks DavisThe lease file is named
559a7feaa1SRuslan Ermilov.Pa dhclient.leases . Ns Ar IFNAME ,
5647c08596SBrooks Daviswhere
579a7feaa1SRuslan Ermilov.Ar IFNAME
5847c08596SBrooks Davisrepresents the network interface the DHCP client acquired the lease on.
5947c08596SBrooks DavisFor example, if
6047c08596SBrooks Davis.Xr dhclient 8
619a7feaa1SRuslan Ermilovis configured for the
629a7feaa1SRuslan Ermilov.Li em0
639a7feaa1SRuslan Ermilovnetwork device,
6447c08596SBrooks Davisthe lease file will be named
659a7feaa1SRuslan Ermilov.Pa dhclient.leases.em0 .
6647c08596SBrooks Davis.Pp
6747c08596SBrooks DavisThe format of the lease declarations is described in
6847c08596SBrooks Davis.Xr dhclient.conf 5 .
6947c08596SBrooks Davis.Sh FILES
709a7feaa1SRuslan Ermilov.Bl -tag -width ".Pa /var/db/dhclient.leases. Ns Ar IFNAME"
719a7feaa1SRuslan Ermilov.It Pa /var/db/dhclient.leases . Ns Ar IFNAME
7247c08596SBrooks DavisCurrent lease file.
7347c08596SBrooks Davis.El
7447c08596SBrooks Davis.Sh SEE ALSO
7547c08596SBrooks Davis.Xr dhclient.conf 5 ,
769a7feaa1SRuslan Ermilov.Xr dhcp-options 5 ,
77*c09eb466SJoel Dahl.Xr dhcpd.conf 5 ,
7847c08596SBrooks Davis.Xr dhclient 8 ,
7947c08596SBrooks Davis.Xr dhcpd 8
809a7feaa1SRuslan Ermilov.Rs
819a7feaa1SRuslan Ermilov.%R "RFC 2132, RFC 2131"
829a7feaa1SRuslan Ermilov.Re
8347c08596SBrooks Davis.Sh AUTHORS
849a7feaa1SRuslan Ermilov.An -nosplit
859a7feaa1SRuslan ErmilovThe
8647c08596SBrooks Davis.Xr dhclient 8
879a7feaa1SRuslan Ermilovutility
8847c08596SBrooks Daviswas written by
89bd0891ceSBaptiste Daroussin.An Ted Lemon Aq Mt mellon@vix.com
9047c08596SBrooks Davisunder a contract with Vixie Labs.
9147c08596SBrooks Davis.Pp
9247c08596SBrooks DavisThe current implementation was reworked by
93bd0891ceSBaptiste Daroussin.An Henning Brauer Aq Mt henning@openbsd.org .
94