Fix documentation for finding the config file name.
authorhpa <hpa>
Sat, 30 Oct 2004 21:17:01 +0000 (21:17 +0000)
committerhpa <hpa>
Sat, 30 Oct 2004 21:17:01 +0000 (21:17 +0000)
pxelinux.doc

index a2717db..b9d0099 100644 (file)
@@ -40,7 +40,13 @@ system may be booted from the same server, the configuration file name
 depends on the IP address of the booting machine.  PXELINUX will
 search for its config file on the boot server in the following way:
 
-  First, it will search for the config file using its own IP address
+  First, it will search for the config file using the hardware type
+  (using its ARP type code) and address, all in lower case hexadecimal
+  with dash separators; for example, for an Ethernet (ARP type 01 hex)
+  with address 88:99:AA:BB:CC:DD it would search for the filename
+  01-88-99-aa-bb-cc-dd.
+  
+  Next, it will search for the config file using its own IP address
   in upper case hexadecimal, e.g. 192.0.2.91 -> C000025B
   (you can use the included progam "gethostip" to compute the
   hexadecimal IP address for any host.)
@@ -49,15 +55,26 @@ search for its config file on the boot server in the following way:
   again.  Ultimately, it will try looking for a file named "default"
   (in lower case).
 
-  As an example, for 192.0.2.91, it will try C000025B, C000025,
-  C00002, C0000, C000, C00, C0, C, and default, in that order.
-
-(See also the section on special DHCP options.)
-
-It should be noted that all filename references are relative to the
-directory pxelinux.0 lives in (usually /tftpboot).  PXELINUX
-generally requires that filenames (including any relative path) are 127
-characters or shorter in length.
+  As an example, if the boot file name is /mybootdir/pxelinux.0, the
+  Ethernet MAC address is 88:99:AA:BB:CC:DD and the IP address
+  192.0.2.91, it will try:
+
+       /mybootdir/pxelinux.cfg/01-88-99-aa-bb-cc-dd
+       /mybootdir/pxelinux.cfg/C000025B
+       /mybootdir/pxelinux.cfg/C000025
+       /mybootdir/pxelinux.cfg/C00002
+       /mybootdir/pxelinux.cfg/C0000
+       /mybootdir/pxelinux.cfg/C000
+       /mybootdir/pxelinux.cfg/C00
+       /mybootdir/pxelinux.cfg/C0
+       /mybootdir/pxelinux.cfg/C
+       /mybootdir/pxelinux.cfg/default
+  ... in that order.
+
+Note that all filename references are relative to the directory
+pxelinux.0 lives in.  PXELINUX generally requires that filenames
+(including any relative path) are 127 characters or shorter in length.
 
 PXELINUX does not support MTFTP, and I have no immediate plans of
 doing so.  It is of course possible to use MTFTP for the initial boot,