doc/pxechn.txt: WDS specifics, example, issue
[profile/ivi/syslinux.git] / doc / pxechn.txt
index a09bbe2..f2638f6 100644 (file)
@@ -2,7 +2,7 @@
 :doctype: manpage
 :author: Gene Cumm
 :email: gene.cumm@gmail.com
-:revdate: 2012-05-27
+:revdate: 2012-05-31
 
 
 == NAME ==
@@ -58,7 +58,9 @@ Chainboot to a new NBP (Network Boot Program) 'FILE' with options to adjust PXE
     wait after loading before booting for user input.
 
 *-W*::
-    Enable WDS (Windows Deployment Services) - specific options.
+    Enable WDS (Windows Deployment Services) - specific options.  'FILE' (or its overrides) must point at the WDS server.
+    *NOTE:* As of 2012-05-31, there is a known issue with gPXE/iPXE, at least with undionly.kkpxe.
+// It appears as if wdsnbp.com walks memory to find a PXE stack
 
 
 == DECIMAL INPUT ==
@@ -76,13 +78,17 @@ pxechn.c32 gpxelinux.0 -p http://172.16.23.1/tftp/ -w -X A012345678 -x 197:00d0d
 pxechn.c32 gpxelinux.0 -p http://172.16.23.1/tftp/ -w -X A012:3456:78 -x 197:00-d0-de-00
        Both of these are equivalent.  Load gpxelinux.0 (relative to the current directory and not altering sname/option 66), set the PXELINUX path prefix, wait after loading, set option 160 to 0x12 0x34 0x56 0x78, and option 197 to 0x00 0xD0 0xDE 0x00.
 
+pxechn.c32 172.16.23.8:boot\x86\wdsnbp.com -W
+pxechn.c32 172.16.23.2:boot\x86\wdsnbp.com -W -o 66.x=ac:10:17:08
+       These are similar but not identical.  Load wdsnbp.com (first example from 172.16.23.8 and the second from 172.16.23.2) but point the packets at 172.16.23.8 for use with WDS.
+
 
 == NOTES ==
-Please note that some NBPs may ignore packet #3 by either not examining it at all or by issuing its own DHCP DISCOVER/REQUEST, negating all DHCP field/option modifications by pxechn.c32.
+Please note that some NBPs may ignore packet #3 by either not examining it at all or by issuing its own DHCP DISCOVER/REQUEST, negating all DHCP field/option modifications by pxechn.c32, including Microsoft Windows Server 2008R2 WDS's wdsnbp.com.
 
 URL specifications in 'FILE' that include user/password before the host will currently cause the siaddr field to not be set properly.
 
-The non-space constraint is due to how Syslinux variants parse the command line as of 2012-01-12.
+The non-space constraint is due to how Syslinux variants parse the command line as of 2012-05-31.
 
 
 == AUTHOR ==