Internet Software Consortium

Dynamic Host Configuration Protocol Distribution

Version 2 Patchlevel 4

August 3, 2000

README FILE

You should read this file carefully before trying to install or use the ISC DHCP Distribution.

    TABLE OF CONTENTS
    WHERE TO FIND DOCUMENTATION
    RELEASE STATUS
    BUILDING THE DHCP DISTRIBUTION
    INSTALLING THE DHCP DISTRIBUTION
    USING THE DHCP DISTRIBUTION
    LINUX
    SO_ATTACH_FILTER UNDECLARED
    PROTOCOL NOT CONFIGURED
    BROADCAST
    FIREWALL RULES
    IP BOOTP AGENT
    MULTIPLE INTERFACES
    SCO
    HP-UX
    ULTRIX
    FreeBSD
    NeXTSTEP
    SOLARIS
    SUPPORT
    HOW TO REPORT BUGS
    KNOWN BUGS

    Where to find documentation

    Documentation for this software includes this README file, the RELNOTES file, and the manual pages, which are in the server, common, client and relay subdirectories. Internet standards relating to the DHCP protocol are stored in the doc subdirectory. You will have the best luck reading the manual pages if you build this software and then install it, although you can read them directly out of the distribution if you need to.

    DHCP server documentation is in the dhcpd man page. Information about the DHCP server lease database is in the dhcpd.leases man page. Server configuration documentation is in the dhcpd.conf man page as well as the dhcp-options man page. A sample DHCP server configuration is in the file server/dhcpd.conf. The source for the dhcpd, dhcpd.leases and dhcpd.conf man pages is in the server/ sub- directory in the distribution. The source for the dhcp-options.5 man page is in the common/ subdirectory.

    DHCP Client documentation is in the dhclient man page. DHCP client configuration documentation is in the dhclient.conf man page and the dhcp-options man page. The DHCP client configuration script is documented in the dhclient-script man page. The format of the DHCP client lease database is documented in the dhclient.leases man page. The source for all these man pages is in the client/ subdirectory in the distribution. In addition, the dhcp-options man page should be referred to for information about DHCP options.

    DHCP relay agent documentation is in the dhcrelay man page, the source for which is distributed in the relay/ subdirectory.

    To read installed manual pages, use the man command. Type "man page" where page is the name of the manual page. This will only work if you have installed the ISC DHCP distribution using the ``make install'' command (described later).

    If you want to read manual pages that aren't installed, you can type ``nroff -man page |more'' where page is the filename of the unformatted manual page. The filename of an unformatted manual page is the name of the manual page, followed by '.', followed by some number - 5 for documentation about files, and 8 for documentation about programs. For example, to read the dhcp-options man page, you would type ``nroff -man common/dhcp-options.5 |more'', assuming your current working directory is the top level directory of the ISC DHCP Distribution.

    If you do not have the nroff command, you can type ``more catpage'' where catpage is the filename of the catted man page. Catted man pages names are the name of the manual page followed by ".cat" followed by 5 or 8, as with unformatted manual pages.

    Please note that until you install the m