vbatts/grub
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

* docs/grub.texi (Network): Update instructions on generating netboot

Browse source 
image.
This commit is contained in:
Vladimir 'phcoder' Serbinenko 2012-12-10 22:22:23 +01:00
parent ce96d01c93
commit b40c88a9c2
2 changed files with 23 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
2012-12-10 Vladimir Serbinenko <phcoder@gmail.com>
* docs/grub.texi (Network): Update instructions on generating netboot
image.
2012-12-10 Vladimir Serbinenko <phcoder@gmail.com> 2012-12-10 Vladimir Serbinenko <phcoder@gmail.com>
* grub-core/disk/cryptodisk.c (grub_cmd_cryptomount): Strip brackets * grub-core/disk/cryptodisk.c (grub_cmd_cryptomount): Strip brackets

35
docs/grub.texi
View file

@ -2080,34 +2080,35 @@ The following properties are supported by all components:
@node Network @node Network
@chapter Booting GRUB from the network @chapter Booting GRUB from the network
The following instructions only work on PC BIOS systems where the Preboot The following instructions don't work for *-emu, i386-qemu, i386-coreboot,
eXecution Environment (PXE) is available. i386-multiboot, mips_loongson, mips-arc and mips_qemu_mips
To generate a PXE boot image, run: To generate a netbootable directory, run:
@example @example
@group @group
grub-mkimage --format=i386-pc-pxe --output=grub.pxe --prefix='(pxe)/boot/grub' pxe pxecmd grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/<platform>
@end group @end group
@end example @end example
Copy @file{grub.pxe}, @file{/boot/grub/*.mod}, and @file{/boot/grub/*.lst} E.g. for i386-pc:
to the PXE (TFTP) server, ensuring that @file{*.mod} and @file{*.lst} are
accessible via the @file{/boot/grub/} path from the TFTP server root. Set
the DHCP server configuration to offer @file{grub.pxe} as the boot file (the
@samp{filename} option in ISC dhcpd).
You can also use the @command{grub-mknetdir} utility to generate an image @example
and a GRUB directory tree, rather than copying files around manually. @group
grub-mknetdir --net-directory=/srv/tftp --subdir=/boot/grub -d /usr/lib/grub/i386-pc
@end group
@end example
Then follow instructions printed out by grub-mknetdir on configuring your DHCP
server.
After GRUB has started, files on the TFTP server will be accessible via the After GRUB has started, files on the TFTP server will be accessible via the
@samp{(pxe)} device. @samp{(tftp)} device.
The server and gateway IP address can be controlled by changing the The server IP address can be controlled by changing the
@samp{(pxe)} device name to @samp{(pxe:@var{server-ip})} or @samp{(tftp)} device name to @samp{(tftp,@var{server-ip})}. Note that
@samp{(pxe:@var{server-ip}:@var{gateway-ip})}. Note that this should be this should be changed both in the prefix and in any references to the
changed both in the prefix and in any references to the device name in the device name in the configuration file.
configuration file.
GRUB provides several environment variables which may be used to inspect or GRUB provides several environment variables which may be used to inspect or
change the behaviour of the PXE device: change the behaviour of the PXE device: