docs/123484: [patch] teach pxeboot.8 about ISC DHCP v3

[Edwin Groothuis]

>Number:         123484
>Category:       docs
>Synopsis:       [patch] teach pxeboot.8 about ISC DHCP v3
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 07 06:50:00 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Edwin Groothuis
>Release:        FreeBSD 6.3-RELEASE i386
>Organization:
-
>Environment:
System: FreeBSD k7.mavetju 6.3-RELEASE FreeBSD 6.3-RELEASE #0: Sun Feb 17 22:11:52 EST 2008 edwin at k7.mavetju:/usr/src/sys/i386/compile/SMP i386


>Description:

Fix documentation in pxeboot.8 with regarding to the DHCP server
configuration lines.

     The pxeboot binary is loaded just like any other boot file, by specifying
     it in the DHCP server's configuration file.  Below is a sample configura-
|    tion for the ISC DHCP v3 server:

           option domain-name "example.com";
           option routers 10.0.0.1;
           option subnet-mask 255.255.255.0;
           option broadcast-address 10.0.0.255;
           option domain-name-servers 10.0.0.1;
           server-name "DHCPserver";
           server-identifier 10.0.0.1;
+          next-server 10.0.0.1;

           default-lease-time 120;
           max-lease-time 120;

           subnet 10.0.0.0 netmask 255.255.255.0 {
                  filename "pxeboot";
                  range 10.0.0.10 10.0.0.254;
           }

+    next-server is the IP address of the next server in the bootstrap
+    process, i.e.  your TFTP server.  pxeboot recognizes option root-path

See also http://www.mavetju.org/weblog/html/00110.html for some
details on the next-server change in the ISC DHCP server.

>How-To-Repeat:
>Fix:

Index: pxeboot.8
===================================================================
RCS file: /home/ncvs/src/sys/boot/i386/pxeldr/pxeboot.8,v
retrieving revision 1.8
diff -u -r1.8 pxeboot.8
--- pxeboot.8	7 Oct 2006 10:39:34 -0000	1.8
+++ pxeboot.8	7 May 2008 06:39:27 -0000
@@ -55,7 +55,7 @@
 .Nm
 binary is loaded just like any other boot file,
 by specifying it in the DHCP server's configuration file.
-Below is a sample configuration for the ISC DHCP v2 server:
+Below is a sample configuration for the ISC DHCP v3 server:
 .Bd -literal -offset indent
 option domain-name "example.com";
 option routers 10.0.0.1;
@@ -64,6 +64,7 @@
 option domain-name-servers 10.0.0.1;
 server-name "DHCPserver";
 server-identifier 10.0.0.1;
+next-server 10.0.0.1;
 
 default-lease-time 120;
 max-lease-time 120;
@@ -74,10 +75,11 @@
 }
 
 .Ed
+.Va next-server
+is the IP address of the next server in the bootstrap process, i.e.
+your TFTP server.
 .Nm
 recognizes
-.Va next-server
-and
 .Va option root-path
 directives as the server and path to NFS mount for file requests,
 respectively, or the server to make TFTP requests to.
>Release-Note:
>Audit-Trail:
>Unformatted: