added a new chapter for the netboot.

ChangeLog

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

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

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
 

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