[syslinux:master] doc/pxechn.txt: WDS specifics, example, issue

[syslinux-bot for Gene Cumm]

Commit-ID:  3cf65ff842c9017195646e684a437d100316dfe9
Gitweb:     http://www.syslinux.org/commit/3cf65ff842c9017195646e684a437d100316dfe9
Author:     Gene Cumm <gene.cumm at gmail.com>
AuthorDate: Thu, 31 May 2012 23:04:43 -0400
Committer:  Gene Cumm <gene.cumm at gmail.com>
CommitDate: Thu, 31 May 2012 23:04:43 -0400

doc/pxechn.txt: WDS specifics, example, issue

Notes on using the WDS option.  Known issue with gPXE/iPXE

Signed-off-by: Gene Cumm <gene.cumm at gmail.com>

---
 doc/pxechn.txt |   14 ++++++++++----
 1 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/doc/pxechn.txt b/doc/pxechn.txt
index a09bbe2..f2638f6 100644
--- a/doc/pxechn.txt
+++ b/doc/pxechn.txt
@@ -2,7 +2,7 @@
 :doctype: manpage
 :author: Gene Cumm
 :email: gene.cumm at 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 ==