From bc8032b6910c8ed475f499f9780916e746ffa0b7 Mon Sep 17 00:00:00 2001 From: hpa Date: Sat, 30 Oct 2004 21:17:01 +0000 Subject: [PATCH] Fix documentation for finding the config file name. --- pxelinux.doc | 37 +++++++++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 10 deletions(-) diff --git a/pxelinux.doc b/pxelinux.doc index a2717db..b9d0099 100644 --- a/pxelinux.doc +++ b/pxelinux.doc @@ -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, -- 2.7.4