sbin/dhclient/dhclient.leases.5

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