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

added a new chapter for the netboot.

Browse source
This commit is contained in:
okuji 2000-02-26 19:13:44 +00:00
parent 098d98d047
commit 547c203a98
4 changed files with 64 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

4
ChangeLog
View file

@ -1,3 +1,7 @@
2000-02-27 OKUJI Yoshinori <okuji@gnu.org>
* docs/tutorial.texi (Network): New chapter.
2000-02-26 OKUJI Yoshinori <okuji@gnu.org>
* docs/help2man: Upgraded to 1.020.

5
docs/grub.texi
View file

@ -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

45
docs/tutorial.texi
View file

@ -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

12
docs/user-ref.texi
View file

@ -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