|
 |
a5bd9f6 |
From 80fa6c9eaeb13ed950d44bae4890c5b2da7ea6f1 Mon Sep 17 00:00:00 2001
|
|
|
a5bd9f6 |
From: Vladimir 'phcoder' Serbinenko <phcoder@gmail.com>
|
|
|
a5bd9f6 |
Date: Mon, 10 Dec 2012 22:22:23 +0100
|
|
|
a5bd9f6 |
Subject: [PATCH 067/364] * docs/grub.texi (Network): Update
|
|
|
a5bd9f6 |
instructions on generating netboot image.
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
---
|
|
|
a5bd9f6 |
ChangeLog | 5 +++++
|
|
|
a5bd9f6 |
docs/grub.texi | 35 ++++++++++++++++++-----------------
|
|
|
a5bd9f6 |
2 files changed, 23 insertions(+), 17 deletions(-)
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
diff --git a/ChangeLog b/ChangeLog
|
|
|
a5bd9f6 |
index 8d7d988..04ffaec 100644
|
|
|
a5bd9f6 |
--- a/ChangeLog
|
|
|
a5bd9f6 |
+++ b/ChangeLog
|
|
|
a5bd9f6 |
@@ -1,5 +1,10 @@
|
|
|
a5bd9f6 |
2012-12-10 Vladimir Serbinenko <phcoder@gmail.com>
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
+ * docs/grub.texi (Network): Update instructions on generating netboot
|
|
|
a5bd9f6 |
+ image.
|
|
|
a5bd9f6 |
+
|
|
|
a5bd9f6 |
+2012-12-10 Vladimir Serbinenko <phcoder@gmail.com>
|
|
|
a5bd9f6 |
+
|
|
|
a5bd9f6 |
* grub-core/disk/cryptodisk.c (grub_cmd_cryptomount): Strip brackets
|
|
|
a5bd9f6 |
around device name if necessarry.
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
diff --git a/docs/grub.texi b/docs/grub.texi
|
|
|
a5bd9f6 |
index b0e7f59..39d9614 100644
|
|
|
a5bd9f6 |
--- a/docs/grub.texi
|
|
|
a5bd9f6 |
+++ b/docs/grub.texi
|
|
|
a5bd9f6 |
@@ -2080,34 +2080,35 @@ The following properties are supported by all components:
|
|
|
a5bd9f6 |
@node Network
|
|
|
a5bd9f6 |
@chapter Booting GRUB from the network
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
-The following instructions only work on PC BIOS systems where the Preboot
|
|
|
a5bd9f6 |
-eXecution Environment (PXE) is available.
|
|
|
a5bd9f6 |
+The following instructions don't work for *-emu, i386-qemu, i386-coreboot,
|
|
|
a5bd9f6 |
+i386-multiboot, mips_loongson, mips-arc and mips_qemu_mips
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
-To generate a PXE boot image, run:
|
|
|
a5bd9f6 |
+To generate a netbootable directory, run:
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
@example
|
|
|
a5bd9f6 |
@group
|
|
|
a5bd9f6 |
-grub-mkimage --format=i386-pc-pxe --output=grub.pxe --prefix='(pxe)/boot/grub' pxe pxecmd
|
|
|
a5bd9f6 |
+grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/<platform>
|
|
|
a5bd9f6 |
@end group
|
|
|
a5bd9f6 |
@end example
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
-Copy @file{grub.pxe}, @file{/boot/grub/*.mod}, and @file{/boot/grub/*.lst}
|
|
|
a5bd9f6 |
-to the PXE (TFTP) server, ensuring that @file{*.mod} and @file{*.lst} are
|
|
|
a5bd9f6 |
-accessible via the @file{/boot/grub/} path from the TFTP server root. Set
|
|
|
a5bd9f6 |
-the DHCP server configuration to offer @file{grub.pxe} as the boot file (the
|
|
|
a5bd9f6 |
-@samp{filename} option in ISC dhcpd).
|
|
|
a5bd9f6 |
+E.g. for i386-pc:
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
-You can also use the @command{grub-mknetdir} utility to generate an image
|
|
|
a5bd9f6 |
-and a GRUB directory tree, rather than copying files around manually.
|
|
|
a5bd9f6 |
+@example
|
|
|
a5bd9f6 |
+@group
|
|
|
a5bd9f6 |
+grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/i386-pc
|
|
|
a5bd9f6 |
+@end group
|
|
|
a5bd9f6 |
+@end example
|
|
|
a5bd9f6 |
+
|
|
|
a5bd9f6 |
+Then follow instructions printed out by grub-mknetdir on configuring your DHCP
|
|
|
a5bd9f6 |
+server.
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
After GRUB has started, files on the TFTP server will be accessible via the
|
|
|
a5bd9f6 |
-@samp{(pxe)} device.
|
|
|
a5bd9f6 |
+@samp{(tftp)} device.
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
-The server and gateway IP address can be controlled by changing the
|
|
|
a5bd9f6 |
-@samp{(pxe)} device name to @samp{(pxe:@var{server-ip})} or
|
|
|
a5bd9f6 |
-@samp{(pxe:@var{server-ip}:@var{gateway-ip})}. Note that this should be
|
|
|
a5bd9f6 |
-changed both in the prefix and in any references to the device name in the
|
|
|
a5bd9f6 |
-configuration file.
|
|
|
a5bd9f6 |
+The server IP address can be controlled by changing the
|
|
|
a5bd9f6 |
+@samp{(tftp)} device name to @samp{(tftp,@var{server-ip})}. Note that
|
|
|
a5bd9f6 |
+this should be changed both in the prefix and in any references to the
|
|
|
a5bd9f6 |
+device name in the configuration file.
|
|
|
a5bd9f6 |
|
|
|
a5bd9f6 |
GRUB provides several environment variables which may be used to inspect or
|
|
|
a5bd9f6 |
change the behaviour of the PXE device:
|
|
|
a5bd9f6 |
--
|
|
|
a5bd9f6 |
1.8.1.4
|
|
|
a5bd9f6 |
|