From a92313f507934d8a8a9b07d83d8a16e29ba60e5b Mon Sep 17 00:00:00 2001 From: okuji Date: Wed, 19 Jan 2000 10:52:27 +0000 Subject: [PATCH] change the option name root to root-directory for grub-install, update the FAQ. --- ChangeLog | 11 +++++++++++ docs/appendices.texi | 25 ++++++++++++++++++++++++- docs/grub-install.8 | 2 +- docs/user-ref.texi | 9 +++++++-- util/grub-install.in | 10 +++++----- 5 files changed, 48 insertions(+), 9 deletions(-) diff --git a/ChangeLog b/ChangeLog index bd673b7e2..d892b5198 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2000-01-19 OKUJI Yoshinori + + * util/grub-install.in (--root): Renamed to ... + (--root-directory): ... this, since "root" is vague. + * docs/user-ref.texi (Invoking grub-install): Adjusted to the + change above, and added an example how to use --root-directory. + * docs/grub-install.8: Regenerated. + + * docs/appendices.texi (FAQ): Added an item about the sucked + SCSI problem. + 2000-01-15 OKUJI Yoshinori * stage2/builtins.c (chainloader_func): If --force is specified diff --git a/docs/appendices.texi b/docs/appendices.texi index 344085628..298aa505d 100644 --- a/docs/appendices.texi +++ b/docs/appendices.texi @@ -11,7 +11,7 @@ order for everybody to participate it. Technically speaking, GNU GRUB has many features that are not seen in the original GRUB. For example, GNU GRUB can be installed on -UNIX-like operating system (i.e. GNU/Linux) via the grub shell +UNIX-like operating system (such as GNU/Linux) via the grub shell @file{/sbin/grub}, it supports Logical Block Address (LBA) mode that solves the 1024 cylinders problem, and @kbd{@key{TAB}} completes a filename when it's unique. Of course, many bug fixes are done as well, @@ -109,6 +109,29 @@ $ ./configure --with-binutils=/usr/local/bin If you follow the instructions above but GRUB still crashes, probably there is a serious bug in GRUB. @xref{Reporting bugs}. +@item GRUB hangs up when accessing my SCSI disk. + +Check if you have turned on the support for INT 13 extension (LBA). If +so, disable the support and see if GRUB can now access your SCSI +disk. This will make it clear that your SCSI BIOS sucks. + +For now, we know the following doesn't provide working LBA mode: + +@table @asis +@item +Adaptec AIC-7880 +@end table + +In the case where you have such a SCSI controller unfortunately, you +cannot use the LBA mode, though GRUB still works fine in the CHS mode +(so the well-known 1024 cylinders problem comes again to you). + +@strong{Caution:} Actually it has not been verified yet if this bug is +due to the SCSI BIOS or GRUB itself, frankly speaking. Because the +developers haven't seen it by their own eyes. This is why it is +desirable that you investigate the cause seriously if you have the +skill. + @item Why doesn't Linux (FreeBSD, NetBSD, etc.) become Multiboot-compliant? Please ask the maintainers. If all free kernels were diff --git a/docs/grub-install.8 b/docs/grub-install.8 index 437582519..be8ddf8f1 100644 --- a/docs/grub-install.8 +++ b/docs/grub-install.8 @@ -14,7 +14,7 @@ print this message and exit \fB\-v\fR, \fB\-\-version\fR print the version information and exit .TP -\fB\-\-root\fR=\fIDIR\fR +\fB\-\-root\-directory\fR=\fIDIR\fR install GRUB images under the directory DIR instead of the root directory. .TP diff --git a/docs/user-ref.texi b/docs/user-ref.texi index 2713c333e..40a544ecb 100644 --- a/docs/user-ref.texi +++ b/docs/user-ref.texi @@ -1388,10 +1388,15 @@ Print a summary of the command line options and exit. @item --version Print the version number of GRUB and exit. -@item --root=@var{dir} +@item --root-directory=@var{dir} Install GRUB images under the directory @var{dir} instead of the root directory. This option is useful when you want to install GRUB into a -separate partition and a removable disk. +separate partition or a removable disk. Here is an example when you have +a separate @dfn{boot} partition which is mounted on @file{/boot}: + +@example +grub-install --root-directory=/boot '(hd0)' +@end example @item --grub-shell=@var{file} Use @var{file} as the grub shell. You can append arbitrary options to diff --git a/util/grub-install.in b/util/grub-install.in index 010bcea3f..4ec285075 100644 --- a/util/grub-install.in +++ b/util/grub-install.in @@ -45,7 +45,7 @@ Install GRUB on your drive. -h, --help print this message and exit -v, --version print the version information and exit - --root=DIR install GRUB images under the directory DIR + --root-directory=DIR install GRUB images under the directory DIR instead of the root directory. --grub-shell=FILE use FILE as the grub shell. @@ -118,8 +118,8 @@ for option; do -v | --version) echo "grub-install (GNU GRUB ${VERSION})" exit 0 ;; - --root=*) - rootdir=`echo $option | sed 's/--root=//'` ;; + --root-directory=*) + rootdir=`echo $option | sed 's/--root-directory=//'` ;; --grub-shell=*) grub_shell=`echo $option | sed 's/--grub-shell=//'` ;; # This is an undocumented feature... @@ -219,8 +219,8 @@ grubdir_device=`df ${grubdir} | grep /dev/ | sed 's%.*\(/dev/[a-z0-9]*\).*%\1%'` if test $grubdir_device != $root_device; then # For now, cannot deal with this situation. cat <2 -For now, cannot deal with the situation that $grubdir does not exist -in the root device. Install GRUB manually instead. +You must set the root directory by the option --root-directory, because +$grubdir does not exist in the root device $root_device. EOF exit 1 fi