summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGene Cumm <gene.cumm@gmail.com>2012-06-01 23:26:40 -0400
committerGene Cumm <gene.cumm@gmail.com>2012-06-01 23:26:40 -0400
commit2c6cd98a70980c419a0e45624b10f93a0548a3e9 (patch)
treebf121844cb07dd2d0335b3a7873d2e7024efa869 /doc
parent616162f3564a3cebc8e18c8033fee4e244db5271 (diff)
downloadsyslinux-2c6cd98a70980c419a0e45624b10f93a0548a3e9.tar.gz
doc/pxechn.txt: add -S, examples, clarify
Signed-off-by: Gene Cumm <gene.cumm@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/pxechn.txt19
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/pxechn.txt b/doc/pxechn.txt
index f2638f62..2c68d633 100644
--- a/doc/pxechn.txt
+++ b/doc/pxechn.txt
@@ -2,7 +2,7 @@
:doctype: manpage
:author: Gene Cumm
:email: gene.cumm@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 ==