sbin/dhclient/dhclient.leases.5

   1 .\"     $OpenBSD: src/sbin/dhclient/dhclient.leases.5,v 1.7 2012/09/22 20:09:43 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 .Dd August 7, 2014
  40 .Dt DHCLIENT.LEASES 5
  41 .Os
  42 .Sh NAME
  43 .Nm dhclient.leases
  44 .Nd DHCP client lease database
  45 .Sh DESCRIPTION
  46 .Xr dhclient 8
  47 keeps a persistent database of leases that it has acquired that are still
  48 valid.
  49 The database is a free-form ASCII file containing one valid declaration
  50 per lease.
  51 The file is written as a log, so the last declaration is the most recent
  52 lease obtained.
  53 .Pp
  54 The lease file is named
  55 .Pa /var/db/dhclient.leases. Ns Aq Ar IFNAME ,
  56 where
  57 .Qq IFNAME
  58 represents the network interface
  59 .Xr dhclient 8
  60 acquired the lease on.
  61 For example, if
  62 .Xr dhclient 8
  63 is configured for the em0 network device,
  64 the lease file will be named
  65 .Pa /var/db/dhclient.leases.em0 ,
  66 .Pp
  67 The format of the lease declarations is described in
  68 .Xr dhclient.conf 5 .
  69 .Sh FILES
  70 .Bl -tag -width "/var/db/dhclient.leases.IFNAME   "
  71 .It Pa /var/db/dhclient.leases. Ns Aq Ar IFNAME ,
  72 Current lease file.
  73 .El
  74 .Sh SEE ALSO
  75 .Xr dhclient.conf 5 ,
  76 .Xr dhcp-options 5 ,
  77 .Xr dhcpd.conf 5 ,
  78 .Xr dhclient 8 ,
  79 .Xr dhcpd 8
  80 .Sh STANDARDS
  81 .Rs
  82 .%A R. Droms
  83 .%D March 1997
  84 .%R RFC 2131
  85 .%T Dynamic Host Configuration Protocol
  86 .Re
  87 .Pp
  88 .Rs
  89 .%A S. Alexander
  90 .%A R. Droms
  91 .%D March 1997
  92 .%R RFC 2132
  93 .%T DHCP Options and BOOTP Vendor Extensions
  94 .Re
  95 .Sh AUTHORS
  96 .An -nosplit
  97 .Xr dhclient 8
  98 was written by
  99 .An Ted Lemon Aq Mt mellon@vix.com
 100 under a contract with Vixie Labs.
 101 .Pp
 102 The current implementation was reworked by
 103 .An Henning Brauer Aq Mt henning@openbsd.org .