svn commit: r318991 - head/sys/boot/i386/pxeldr

[Baptiste Daroussin]

Author: bapt
Date: Sat May 27 13:26:18 2017
New Revision: 318991
URL: https://svnweb.freebsd.org/changeset/base/318991

Log:
  Document recent changes on pxeboot

Modified:
  head/sys/boot/i386/pxeldr/pxeboot.8

Modified: head/sys/boot/i386/pxeldr/pxeboot.8
==============================================================================
--- head/sys/boot/i386/pxeldr/pxeboot.8	Sat May 27 12:46:46 2017	(r318990)
+++ head/sys/boot/i386/pxeldr/pxeboot.8	Sat May 27 13:26:18 2017	(r318991)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 16, 2017
+.Dd May 27, 2017
 .Dt PXEBOOT 8
 .Os
 .Sh NAME
@@ -39,6 +39,11 @@ configured to run under Intel's Preboot 
 PXE is a form of smart boot ROM, built into Intel EtherExpress Pro/100 and
 3Com 3c905c Ethernet cards, and Ethernet-equipped Intel motherboards.
 PXE supports DHCP configuration and provides low-level NIC access services.
+.Pp
+The DHCP client will set a DHCP user class named
+.Va FREEBSD
+to allow flexible configuration of the dhcp server.
+.Pp
 The
 .Nm
 bootloader retrieves the kernel, modules,
@@ -69,6 +74,9 @@ 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;
+       if exists user-class and option user-class = "FREEBSD" {
+            option root-path "tftp://10.0.0.1/FreeBSD";
+       }
 }
 
 .Ed
@@ -85,6 +93,27 @@ expects to fetch
 .Pa /boot/loader.rc
 from the specified server before loading any other files.
 .Pp
+Valid
+.Va option root-path
+Syntax is the following
+.Bl -tag -width <scheme>://ip/path indent
+.It /path
+path to the root filesystem on the NFS server
+.It ip:/path
+path to the root filesystem on the NFS server
+.Ar ip
+.It nfs:/path
+path to the root filesystem on the NFS server
+.It nfs://ip/path
+path to the root filesystem on the NFS server
+.Ar ip
+.It tftp:/path
+path to the root filesystem on the TFTP server
+.It tftp://ip/path
+path to the root filesystem on the TFTP server
+.Ar ip
+.El
+.Pp
 .Nm
 defaults to a conservative 1024 byte NFS data packet size.
 This may be changed by setting the