From 547c203a98a342c37c982f1c8beaac25dab68e91 Mon Sep 17 00:00:00 2001 From: okuji Date: Sat, 26 Feb 2000 19:13:44 +0000 Subject: [PATCH] added a new chapter for the netboot. --- ChangeLog | 4 ++++ docs/grub.texi | 5 +++-- docs/tutorial.texi | 45 +++++++++++++++++++++++++++++++++++++++++++++ docs/user-ref.texi | 12 ++++++++++++ 4 files changed, 64 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index efc2d9adb..313b79a2b 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +2000-02-27 OKUJI Yoshinori + + * docs/tutorial.texi (Network): New chapter. + 2000-02-26 OKUJI Yoshinori * docs/help2man: Upgraded to 1.020. diff --git a/docs/grub.texi b/docs/grub.texi index 8130f1260..9b198bfaa 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -25,7 +25,7 @@ @ifinfo Copyright @copyright{} 1996 Erich Boleyn -Copyright @copyright{} 1999 Free Software Foundation, Inc. +Copyright @copyright{} 1999, 2000 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -58,7 +58,7 @@ into another language, under the above conditions for modified versions. @vskip 0pt plus 1filll @vskip 0pt plus 1filll Copyright @copyright{} 1996 Erich Boleyn -Copyright @copyright{} 1999 Free Software Foundation, Inc. +Copyright @copyright{} 1999, 2000 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -92,6 +92,7 @@ Part I: The Tutorial Manual * Filename:: How to write filenames * Installation:: How to install GRUB on your drive * Boot:: How to boot your operating systems +* Network:: Downloading OS images from a network * Configuration:: Writing your configuration file Part II: The User Reference Manual diff --git a/docs/tutorial.texi b/docs/tutorial.texi index 43582ccf9..1a099869a 100644 --- a/docs/tutorial.texi +++ b/docs/tutorial.texi @@ -511,6 +511,51 @@ grub> boot @end example +@node Network +@chapter Downloading OS images from a network + +Although GRUB is a disk-based boot loader, it provides you some network +support. To using the network support, you need to enable at least one +network driver in the build process. See the file +@file{netboot/README.netboot} in the source distribution, for more +information. + +First, you have to set up servers in your network. The servers GRUB +requires are a server which assigns an IP address and a file server. The +former is one of a BOOTP server, a DHCP server and a RARP server. RARP +is deprecated, since it cannot serve much information. For the latter, +only TFTP is supported at the moment. It is not necessary to run both +the servers on one computer. How to configure the servers is beyond the +scope of this document, so please refer to their own manuals. + +Second, run @command{bootp}, @command{dhcp} and @command{rarp} for +BOOTP, DHCP and RARP, respectively. Each command will show an assigned +IP address, a netmask, an IP address for your TFTP server and a +gateway. If any of the addresses is wrong or it causes an error, +probably the configuration of your servers isn't set up properly. + +Lastly, download your OS images from your network. The network can be +accessed by the network drive @samp{(nd)}. Everything else is similar to +the normal instructions (@pxref{Boot}). + +Here is an example: + +@example +@group +grub> bootp +Probing... [NE*000] +NE2000 base ... +Address: 192.168.110.23 Netmask: 255.255.255.0 +Server: 192.168.110.14 Gateway: 192.168.110.1 + +grub> root (nd) +grub> kernel /tftproot/gnumach.gz root=sd0s1 +grub> module /tftproot/serverboot.gz +grub> boot +@end group +@end example + + @node Configuration @chapter Configuration diff --git a/docs/user-ref.texi b/docs/user-ref.texi index 3131fc908..3cbf65ad9 100644 --- a/docs/user-ref.texi +++ b/docs/user-ref.texi @@ -150,6 +150,10 @@ standard interface used in all machines. However, some newer machines have the new interface, Logical Block Address (@dfn{LBA}) mode. GRUB automatically detects if LBA mode is available and uses it if available. In LBA mode, GRUB can access the entire disk. + +@item Network support +GRUB is a disk-based boot loader but also has network support. You can +load OS images from a network by using the @dfn{TFTP} protocol. @end table Future directions might include an internal programming language for @@ -249,6 +253,10 @@ MBR when installing GRUB), while the syntax like @samp{(hd0,0)} represents using the partition of the disk (or the boot sector of the partition when installing GRUB). +If you enabled the network support, the special drive, @samp{(nd)}, is +also available. Before using the network drive, you must initiailze the +network. @xref{Network}, for more information. + @node Filename syntax @section How to specify files @@ -371,6 +379,10 @@ cursor is after the first word, the @kbd{@key{TAB}} will provide a completion listing of disks, partitions, and filenames depending on the context. +Note that you cannot use the completion functionality in the TFTP +filesystem. This is because TFTP doesn't support filename listing for +the security. + @node Menu @section The simple menu interface