[syslinux:master] doc/pxechn.txt: add -S, examples, clarify

syslinux-bot for Gene Cumm gene.cumm at gmail.com
Mon Oct 22 12:51:06 PDT 2012


Commit-ID:  2c6cd98a70980c419a0e45624b10f93a0548a3e9
Gitweb:     http://www.syslinux.org/commit/2c6cd98a70980c419a0e45624b10f93a0548a3e9
Author:     Gene Cumm <gene.cumm at gmail.com>
AuthorDate: Fri, 1 Jun 2012 23:26:40 -0400
Committer:  Gene Cumm <gene.cumm at gmail.com>
CommitDate: Fri, 1 Jun 2012 23:26:40 -0400

doc/pxechn.txt: add -S, examples, clarify

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

---
 doc/pxechn.txt |   19 +++++++++++--------
 1 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/doc/pxechn.txt b/doc/pxechn.txt
index f2638f6..2c68d63 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-31
+:revdate: 2012-06-01
 
 
 == NAME ==
@@ -48,6 +48,9 @@ Chainboot to a new NBP (Network Boot Program) 'FILE' with options to adjust PXE
 *-r*::
     Call the PXE stack with PXENV_RESTART_TFTP.  _Must_ be the only option and before 'FILE'.
 
+*-S*::
+    Set sip based on sname field/option 66 (by direct IP if a period-delimited address or otherwise DNS).
+
 *-t* 'SECONDS'::
     PXELINUX timeout (DHCP Option 211).
 
@@ -58,7 +61,7 @@ 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.  'FILE' (or its overrides) must point at the WDS server.
+    Enable WDS (Windows Deployment Services) - specific options.  'FILE' (or its overrides for DHCP fields siaddr and file) 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
 
@@ -71,16 +74,16 @@ All parameters that are defaulted to decimal format are processed by *strtoul*(3
 pxechn.c32 http://myhost.dom.loc/path/nbp.0 -c myconfig
 	Load nbp.0 and set PXELINUX config (option 209).
 
-pxechn.c32 gpxelinux.0 -p http://172.16.23.1/tftp/ -w -c myconfig -o 15.s=domain.loc -o 6.x=0A:01:01:02:ac:17:4D:Ec -
+pxechn.c32 gpxelinux.0 -p http://10.1.1.4/tftp/ -w -c myconfig -o 15.s=domain.loc -o 6.x=0A:01:01:02:ac:17:4D:Ec -
 	Load gpxelinux.0 from the current directory, set prefix, wait to execute, set first config, set the domain name and 2 domain name servers (case mixed to show insensitivity; 10.1.1.2 and 172.23.77.236).
 
-pxechn.c32 gpxelinux.0 -p http://172.16.23.1/tftp/ -w -X A012345678 -x 197:00d0de00
-pxechn.c32 gpxelinux.0 -p http://172.16.23.1/tftp/ -w -X A012:3456:78 -x 197:00-d0-de-00
+pxechn.c32 gpxelinux.0 -p http://10.1.1.4/tftp/ -w -X A012345678 -x 197:00d0de00
+pxechn.c32 gpxelinux.0 -p http://10.1.1.4/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.
+pxechn.c32 10.1.1.8:boot\x86\wdsnbp.com -W
+pxechn.c32 10.1.1.4:boot\x86\wdsnbp.com -W -o 66.x=0a:01:01:08 -S
+	These are similar but not identical.  Load wdsnbp.com (first example from 10.1.1.8 and the second from 10.1.1.4) but point the packets at 10.1.1.8 for use with WDS.  DHCP Option 66 will be placed in DHCP field sname when there's room.  -S decodes this to an IPv4 address.
 
 
 == NOTES ==


More information about the Syslinux-commits mailing list