[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Another boot example for hurd.texi
From: |
James A Morrison |
Subject: |
Another boot example for hurd.texi |
Date: |
Wed, 23 Jan 2002 22:35:16 -0500 (EST) |
Here is a patch for hurd.texi that adds some information on using boot.
It also fixes a typo.
2002-01-23 James A. Morrison <ja2morri@uwaterloo.ca>
* hurd.texi (Boot Program): Added section for program 'boot'.
(Recursive Bootstrap): Added a real partition example.
Updated copyright dates.
Index: hurd.texi
===================================================================
RCS file: /cvsroot/hurd/hurd/doc/hurd.texi,v
retrieving revision 1.20
diff -u -r1.20 hurd.texi
--- hurd.texi 12 Mar 2001 00:43:50 -0000 1.20
+++ hurd.texi 24 Jan 2002 03:28:44 -0000
@@ -98,7 +98,7 @@
@end direntry
@ifinfo
-Copyright @copyright{} 1994-2000 Free Software Foundation, Inc.
+Copyright @copyright{} 1994-2002 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -131,7 +131,7 @@
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1994--2000 Free Software Foundation, Inc.
+Copyright @copyright{} 1994--2002 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@@ -170,6 +170,7 @@
* Terminal Handling:: Helping people interact with the Hurd.
* Running Programs:: Program execution and process management.
* Authentication:: Verifying user and server privileges.
+* Boot Program:: Options for the boot menu
* Index:: Guide to concepts, functions, and files.
@detailmenu
@@ -337,6 +338,10 @@
* Auth Protocol:: Bidirectional authentication.
+Boot Program
+
+* Boot Options::
+
@end detailmenu
@end menu
@@ -666,8 +671,8 @@
@cindex GRUB
@cindex GRand Unified Bootloader
Currently, @dfn{GRUB}@footnote{The GRand Unified Bootloader, available
-from @uref{http://www.uruk.org/grub/}.} is the preferred GNU bootloader.
-GRUB provides advanced functionality, and is capable of loading several
+from @uref{http://www.gnu.org/software/grub/}.} is the GNU bootloader.
+GNU GRUB provides advanced functionality, and is capable of loading several
different kernels (such as Linux, DOS, and the *BSD family).
From the standpoint of the Hurd, the bootloader is just a mechanism to
@@ -810,7 +815,7 @@
$ @kbd{cd my-root}
$ @kbd{tar -zxpf /pub/debian/FIXME/gnu-20000929.tar.gz}
$ @kbd{cd ..}
-$ @kbd{fsysopts ./my-root --read-only}
+$ @kbd{fsysopts ./my-root --readonly}
$
@end example
@@ -824,6 +829,19 @@
$ @kbd{boot -D ./my-boot ./my-boot/boot/servers.boot ./my-partition}
[...]
@end example
+
+@item
+ Here is an example using a hard drive that already has GNU Hurd installed.
+Assuming that the Hurd is installed on and extended 2 filesystem on /dev/hd2s1.
+
+@example
+$ @kbd{settrans /mnt /hurd/ex2fs --readonly /dev/hd2s1}
+$ @kbd{boot -d -D /mnt -I /mnt/boot/servers.boot /dev/hd2s1}
+@end example
+
+@item
+ See @pxref{Boot Options} for help with boot.
+
@end enumerate
Note that it is impossible to share microkernel devices between the two
@@ -4606,6 +4624,63 @@
FIXME: finish
+@node Boot Program
+@chapter Boot Program
+@menu
+* Boot Options:: Boot program command line options
+@end menu
+
+@node Boot Options
+@section Boot Options
+
+Usage: boot [OPTION...] @var{BOOT-SCRIPT} @var{DEVICE}...
+
+@table @code
+@item --kernel-command-line=@var{COMMAND LINE}
+@itemx -c
+Simulated multiboot command line to supply
+
+@item --pause
+@itemx -d
+Pause for user confirmation at various times during booting
+
+@item --boot-root=@var{DIR}
+@itemx -D
+Root of a directory tree in which to find files specified in @var{BOOT-SCRIPT}
+
+@item --interleave=@var{BLOCKS}
+Interleave in runs of length @var{BLOCKS}
+
+@item --isig
+@itemx -I
+Do not disable terminal signals, so you can suspend and interrupt boot.
+
+@item --layer
+@itemx -L
+ Layer multiple devices for redundancy
+
+@item --single-user
+@itemx -s
+ Boot in single user mode
+
+@item --store-type=@var{TYPE}
+@itemx -T
+Each @var{DEVICE} names a store of type @var{TYPE}
+
+@item --help
+@itemx -?
+Gives a help list
+
+@item --usage
+Give a short usage message
+@end table
+
+Mandatory or optional arguments to long options are also mandatory or optional
+for any corresponding short options.
+
+
+If neither @option{--interleave} or @option{--layer} is specified, multiple
+@var{DEVICE}s are concatenated.
@node Index
@unnumbered Index
- Another boot example for hurd.texi,
James A Morrison <=