Initial stab at Mach-style partition names, LBA mode, and documentation.
This commit is contained in:
gord
parent
8d793b9a7e
commit
d34ac5a182
11 changed files with 472 additions and 32 deletions
|
|
@ -2,4 +2,5 @@ html = boot-proposal.html errors.html faq.html grub.html install.html \
|
|||
mem64mb.html technical.html using.html
|
||||
txt = PC_partitioning.txt bios_mapping.txt commands.txt embedded_data.txt \
|
||||
filesystem.txt
|
||||
info_TEXINFOS = grub.texi
|
||||
EXTRA_DIST = BUGS $(txt) $(html) menu.lst
|
||||
|
|
|
|||
175
docs/Makefile.in
175
docs/Makefile.in
|
|
@ -74,19 +74,27 @@ html = boot-proposal.html errors.html faq.html grub.html install.html \
|
|||
mem64mb.html technical.html using.html
|
||||
txt = PC_partitioning.txt bios_mapping.txt commands.txt embedded_data.txt \
|
||||
filesystem.txt
|
||||
info_TEXINFOS = grub.texi
|
||||
EXTRA_DIST = BUGS $(txt) $(html) menu.lst
|
||||
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
|
||||
CONFIG_CLEAN_FILES =
|
||||
DIST_COMMON = COPYING Makefile.am Makefile.in TODO
|
||||
TEXI2DVI = texi2dvi
|
||||
TEXINFO_TEX = $(srcdir)/texinfo.tex
|
||||
INFO_DEPS = grub.info
|
||||
DVIS = grub.dvi
|
||||
TEXINFOS = grub.texi
|
||||
DIST_COMMON = COPYING Makefile.am Makefile.in TODO mdate-sh stamp-vti \
|
||||
version.texi
|
||||
|
||||
|
||||
DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST)
|
||||
|
||||
TAR = tar
|
||||
GZIP = --best
|
||||
all: Makefile
|
||||
all: Makefile $(INFO_DEPS)
|
||||
|
||||
.SUFFIXES:
|
||||
.SUFFIXES: .dvi .info .ps .texi .texinfo .txi
|
||||
$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.in $(ACLOCAL_M4)
|
||||
cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/Makefile
|
||||
|
||||
|
|
@ -94,6 +102,140 @@ Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status $(BUILT_SOURCES)
|
|||
cd $(top_builddir) \
|
||||
&& CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
|
||||
|
||||
|
||||
version.texi: stamp-vti
|
||||
cp $(srcdir)/stamp-vti $(srcdir)/version.texi
|
||||
|
||||
stamp-vti: grub.texi $(top_srcdir)/configure.in
|
||||
@echo "@set UPDATED `cd $(srcdir) \
|
||||
&& $(SHELL) ./mdate-sh grub.texi`" > vti.tmp
|
||||
@echo "@set EDITION $(VERSION)" >> vti.tmp
|
||||
@echo "@set VERSION $(VERSION)" >> vti.tmp
|
||||
@cmp -s vti.tmp $(srcdir)/stamp-vti \
|
||||
|| (echo "Updating $(srcdir)/stamp-vti"; \
|
||||
cp vti.tmp $(srcdir)/stamp-vti)
|
||||
-@rm -f vti.tmp
|
||||
|
||||
mostlyclean-vti:
|
||||
-rm -f vti.tmp
|
||||
|
||||
clean-vti:
|
||||
|
||||
distclean-vti:
|
||||
|
||||
maintainer-clean-vti:
|
||||
-rm -f stamp-vti version.texi
|
||||
|
||||
grub.info: grub.texi version.texi
|
||||
grub.dvi: grub.texi version.texi
|
||||
|
||||
|
||||
DVIPS = dvips
|
||||
|
||||
.texi.info:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
|
||||
.texi.dvi:
|
||||
TEXINPUTS=$(srcdir):$$TEXINPUTS \
|
||||
MAKEINFO='$(MAKEINFO) -I $(srcdir)' $(TEXI2DVI) $<
|
||||
|
||||
.texi:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
|
||||
.texinfo.info:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
|
||||
.texinfo:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
|
||||
.texinfo.dvi:
|
||||
TEXINPUTS=$(srcdir):$$TEXINPUTS \
|
||||
MAKEINFO='$(MAKEINFO) -I $(srcdir)' $(TEXI2DVI) $<
|
||||
|
||||
.txi.info:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
|
||||
.txi.dvi:
|
||||
TEXINPUTS=$(srcdir):$$TEXINPUTS \
|
||||
MAKEINFO='$(MAKEINFO) -I $(srcdir)' $(TEXI2DVI) $<
|
||||
|
||||
.txi:
|
||||
@cd $(srcdir) && rm -f $@ $@-[0-9] $@-[0-9][0-9]
|
||||
cd $(srcdir) \
|
||||
&& $(MAKEINFO) `echo $< | sed 's,.*/,,'`
|
||||
.dvi.ps:
|
||||
$(DVIPS) $< -o $@
|
||||
|
||||
install-info-am: $(INFO_DEPS)
|
||||
@$(NORMAL_INSTALL)
|
||||
$(mkinstalldirs) $(DESTDIR)$(infodir)
|
||||
@for file in $(INFO_DEPS); do \
|
||||
d=$(srcdir); \
|
||||
for ifile in `cd $$d && echo $$file $$file-[0-9] $$file-[0-9][0-9]`; do \
|
||||
if test -f $$d/$$ifile; then \
|
||||
echo " $(INSTALL_DATA) $$d/$$ifile $(DESTDIR)$(infodir)/$$ifile"; \
|
||||
$(INSTALL_DATA) $$d/$$ifile $(DESTDIR)$(infodir)/$$ifile; \
|
||||
else : ; fi; \
|
||||
done; \
|
||||
done
|
||||
@$(POST_INSTALL)
|
||||
@if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \
|
||||
for file in $(INFO_DEPS); do \
|
||||
echo " install-info --info-dir=$(DESTDIR)$(infodir) $(DESTDIR)$(infodir)/$$file";\
|
||||
install-info --info-dir=$(DESTDIR)$(infodir) $(DESTDIR)$(infodir)/$$file || :;\
|
||||
done; \
|
||||
else : ; fi
|
||||
|
||||
uninstall-info:
|
||||
$(PRE_UNINSTALL)
|
||||
@if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \
|
||||
ii=yes; \
|
||||
else ii=; fi; \
|
||||
for file in $(INFO_DEPS); do \
|
||||
test -z "$ii" \
|
||||
|| install-info --info-dir=$(DESTDIR)$(infodir) --remove $$file; \
|
||||
done
|
||||
@$(NORMAL_UNINSTALL)
|
||||
for file in $(INFO_DEPS); do \
|
||||
(cd $(DESTDIR)$(infodir) && rm -f $$file $$file-[0-9] $$file-[0-9][0-9]); \
|
||||
done
|
||||
|
||||
dist-info: $(INFO_DEPS)
|
||||
for base in $(INFO_DEPS); do \
|
||||
d=$(srcdir); \
|
||||
for file in `cd $$d && eval echo $$base*`; do \
|
||||
test -f $(distdir)/$$file \
|
||||
|| ln $$d/$$file $(distdir)/$$file 2> /dev/null \
|
||||
|| cp -p $$d/$$file $(distdir)/$$file; \
|
||||
done; \
|
||||
done
|
||||
|
||||
mostlyclean-aminfo:
|
||||
-rm -f grub.aux grub.cp grub.cps grub.dvi grub.fn grub.fns grub.ky \
|
||||
grub.kys grub.ps grub.log grub.pg grub.toc grub.tp grub.tps \
|
||||
grub.vr grub.vrs grub.op grub.tr grub.cv grub.cn
|
||||
|
||||
clean-aminfo:
|
||||
|
||||
distclean-aminfo:
|
||||
|
||||
maintainer-clean-aminfo:
|
||||
for i in $(INFO_DEPS); do \
|
||||
rm -f $$i; \
|
||||
if test "`echo $$i-[0-9]*`" != "$$i-[0-9]*"; then \
|
||||
rm -f $$i-[0-9]*; \
|
||||
fi; \
|
||||
done
|
||||
tags: TAGS
|
||||
TAGS:
|
||||
|
||||
|
|
@ -114,25 +256,27 @@ distdir: $(DISTFILES)
|
|||
|| ln $$d/$$file $(distdir)/$$file 2> /dev/null \
|
||||
|| cp -p $$d/$$file $(distdir)/$$file; \
|
||||
done
|
||||
info:
|
||||
dvi:
|
||||
$(MAKE) top_distdir="$(top_distdir)" distdir="$(distdir)" dist-info
|
||||
info: $(INFO_DEPS)
|
||||
dvi: $(DVIS)
|
||||
check: all
|
||||
$(MAKE)
|
||||
installcheck:
|
||||
install-exec:
|
||||
@$(NORMAL_INSTALL)
|
||||
|
||||
install-data:
|
||||
install-data: install-info-am
|
||||
@$(NORMAL_INSTALL)
|
||||
|
||||
install: install-exec install-data all
|
||||
@:
|
||||
|
||||
uninstall:
|
||||
uninstall: uninstall-info
|
||||
|
||||
install-strip:
|
||||
$(MAKE) INSTALL_PROGRAM='$(INSTALL_PROGRAM) -s' INSTALL_SCRIPT='$(INSTALL_PROGRAM)' install
|
||||
installdirs:
|
||||
$(mkinstalldirs) $(DESTDIR)$(infodir)
|
||||
|
||||
|
||||
mostlyclean-generic:
|
||||
|
|
@ -149,21 +293,24 @@ distclean-generic:
|
|||
maintainer-clean-generic:
|
||||
-test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES)
|
||||
-test -z "$(BUILT_SOURCES)" || rm -f $(BUILT_SOURCES)
|
||||
mostlyclean: mostlyclean-generic
|
||||
mostlyclean: mostlyclean-vti mostlyclean-aminfo mostlyclean-generic
|
||||
|
||||
clean: clean-generic mostlyclean
|
||||
clean: clean-vti clean-aminfo clean-generic mostlyclean
|
||||
|
||||
distclean: distclean-generic clean
|
||||
distclean: distclean-vti distclean-aminfo distclean-generic clean
|
||||
-rm -f config.status
|
||||
|
||||
maintainer-clean: maintainer-clean-generic distclean
|
||||
maintainer-clean: maintainer-clean-vti maintainer-clean-aminfo \
|
||||
maintainer-clean-generic distclean
|
||||
@echo "This command is intended for maintainers to use;"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
|
||||
.PHONY: tags distdir info dvi installcheck install-exec install-data \
|
||||
install uninstall all installdirs mostlyclean-generic distclean-generic \
|
||||
clean-generic maintainer-clean-generic clean mostlyclean distclean \
|
||||
maintainer-clean
|
||||
.PHONY: mostlyclean-vti distclean-vti clean-vti maintainer-clean-vti \
|
||||
install-info-am uninstall-info mostlyclean-aminfo distclean-aminfo \
|
||||
clean-aminfo maintainer-clean-aminfo tags distdir info dvi installcheck \
|
||||
install-exec install-data install uninstall all installdirs \
|
||||
mostlyclean-generic distclean-generic clean-generic \
|
||||
maintainer-clean-generic clean mostlyclean distclean maintainer-clean
|
||||
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
|
|
|
|||
185
docs/grub.texi
Normal file
185
docs/grub.texi
Normal file
|
|
@ -0,0 +1,185 @@
|
|||
\input texinfo @c -*-texinfo-*-
|
||||
@setfilename grub.info
|
||||
@include version.texi
|
||||
|
||||
@dircategory Kernel
|
||||
@direntry
|
||||
* GRUB: (grub). The GRand Unified Bootloader.
|
||||
@end direntry
|
||||
|
||||
@ifinfo
|
||||
Copyright @copyright{} 1996 Erich Boleyn
|
||||
Copyright @copyright{} 1999 Free Software Foundation, Inc.
|
||||
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
are preserved on all copies.
|
||||
|
||||
@ignore
|
||||
Permission is granted to process this file through TeX and print the
|
||||
results, provided the printed document carries a copying permission
|
||||
notice identical to this one except for the removal of this paragraph
|
||||
(this paragraph not being relevant to the printed manual).
|
||||
|
||||
@end ignore
|
||||
|
||||
Permission is granted to copy and distribute modified versions of this
|
||||
manual under the conditions for verbatim copying, provided also that
|
||||
the entire resulting derived work is distributed under the terms of a
|
||||
permission notice identical to this one.
|
||||
|
||||
Permission is granted to copy and distribute translations of this manual
|
||||
into another language, under the above conditions for modified versions.
|
||||
@end ifinfo
|
||||
|
||||
@c @setchapternewpage odd
|
||||
@settitle GRUB Manual
|
||||
@titlepage
|
||||
@finalout
|
||||
@title The GRUB Manual
|
||||
@author Gordon Matzigkeit
|
||||
@page
|
||||
|
||||
@vskip 0pt plus 1filll
|
||||
Copyright @copyright{} 1996 Erich Boleyn
|
||||
Copyright @copyright{} 1999 Free Software Foundation, Inc.
|
||||
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
are preserved on all copies.
|
||||
|
||||
Permission is granted to copy and distribute modified versions of this
|
||||
manual under the conditions for verbatim copying, provided also that
|
||||
the entire resulting derived work is distributed under the terms of a
|
||||
permission notice identical to this one.
|
||||
|
||||
Permission is granted to copy and distribute translations of this manual
|
||||
into another language, under the above conditions for modified versions.
|
||||
@end titlepage
|
||||
|
||||
@node Top
|
||||
@top GRUB
|
||||
|
||||
This file documents GNU GRUB, the Grand Unified Bootloader. This
|
||||
edition documents version @value{VERSION}.
|
||||
|
||||
@menu
|
||||
* Introduction:: Capturing the spirit of GRUB.
|
||||
|
||||
@detailmenu
|
||||
--- The Detailed Node Listing ---
|
||||
|
||||
Introduction
|
||||
|
||||
* History:: From maggot to house fly.
|
||||
* Features:: How GRUB is different.
|
||||
* Role of a bootloader:: Judging a system by its bootloader.
|
||||
|
||||
@end detailmenu
|
||||
@end menu
|
||||
|
||||
@node Introduction
|
||||
@chapter Introduction
|
||||
|
||||
Briefly, a @dfn{bootloader} is the first software program that runs when
|
||||
a computer starts. It is responsible for loading and transferring
|
||||
control to the operating system @dfn{kernel} software (such as the Linux
|
||||
or Hurd kernels). The kernel, in turn, initializes the rest of the
|
||||
operating system (usually GNU).
|
||||
|
||||
@menu
|
||||
* History:: From maggot to house fly.
|
||||
* Features:: How GRUB is different.
|
||||
* Role of a bootloader:: Judging a system by its bootloader.
|
||||
@end menu
|
||||
|
||||
|
||||
@node History
|
||||
@section History of GRUB
|
||||
|
||||
GRUB originated in 1995 when Erich Boleyn was trying to boot the GNU
|
||||
Hurd with the University of Utah's Mach 4 microkernel (now known as GNU
|
||||
Mach). Erich and Brian Ford designed the Multiboot Standard (FIXME
|
||||
xref), because they were determined not to add to the large number of
|
||||
mutually-incompatible PC boot methods.
|
||||
|
||||
Erich then began modifying the FreeBSD bootloader so that it would
|
||||
understand Multiboot. He quickly realized that it would be a lot easier
|
||||
to write his own bootloader from scratch than to keep working on the
|
||||
FreeBSD bootloader, and so GRUB was born.
|
||||
|
||||
Erich added many features to GRUB, but other priorities prevented him
|
||||
from keeping up with the demands of its quickly-expanding user base. In
|
||||
1999, Gordon Matzigkeit adopted GRUB as an official GNU package, and
|
||||
opened its development by making the latest sources available via
|
||||
anonymous CVS.@footnote{The repository is
|
||||
@code{:pserver:anoncvs@@anoncvs.gnu.org:/gd/gnu/anoncvsroot}, module
|
||||
@code{grub}. Just hit return when prompted for a password.}
|
||||
|
||||
|
||||
@node Features
|
||||
@section GRUB features
|
||||
technical.html: why another bootloader?
|
||||
|
||||
|
||||
@node Role of a bootloader
|
||||
@section The role of a bootloader
|
||||
|
||||
The following is a quotation from Gordon Matzigkeit, a GRUB fanatic:
|
||||
|
||||
@quotation
|
||||
Some people like to acknowlege both the operating system and kernel when
|
||||
they talk about their computers, so they might say they use
|
||||
``GNU/Linux'' or ``GNU/Hurd''. Other people seem to think that the
|
||||
kernel is the most important part of the system, so they like to call
|
||||
their GNU operating systems ``Linux systems.''
|
||||
|
||||
I, personally, believe that this is a grave injustice, because the
|
||||
@emph{bootloader} is the most important software of all. So, I used to
|
||||
refer to the above systems as either ``LILO''@footnote{The LInux LOader,
|
||||
a bootloader that everybody uses, but nobody likes.} or ``GRUB''
|
||||
systems.
|
||||
|
||||
Unfortunately, nobody ever understood what I was talking about; now I
|
||||
just use the word ``GNU'' as a pseudonym for GRUB.
|
||||
|
||||
So, if you ever hear people talking about their alleged ``GNU'' systems,
|
||||
remember that they are actually paying homage to the best bootloader
|
||||
around@dots{} GRUB!
|
||||
@end quotation
|
||||
|
||||
We, the GRUB maintainers, do not (usually) encourage Gordon's level of
|
||||
fanaticism, but it helps to remember that bootloaders deserve careful
|
||||
design. We hope at least that you enjoy using GNU GRUB as much as we
|
||||
did writing it.
|
||||
|
||||
|
||||
@chapter Using
|
||||
@section using.html
|
||||
|
||||
|
||||
@chapter Boot scripts
|
||||
@section commands.txt
|
||||
|
||||
|
||||
@chapter Disk partitions
|
||||
|
||||
|
||||
@chapter Filesystems
|
||||
@section filesystem.txt
|
||||
|
||||
|
||||
@chapter Troubleshooting
|
||||
@section errors.html
|
||||
|
||||
|
||||
@chapter Multiboot
|
||||
@section boot-proposal.html
|
||||
|
||||
|
||||
@chapter Implementation
|
||||
@section technical.html
|
||||
@section embedded_data.txt
|
||||
@section PC_patitioning.txt
|
||||
|
||||
@bye
|
||||
|
|
@ -61,7 +61,7 @@ only room for a very sparse functionality.<P>
|
|||
GRUB is very large compared to other bootloaders (typically
|
||||
20 to 30 K). A mechanism is
|
||||
in place which can load all of it's components for different
|
||||
<A HREF=install.html>installal methods</A>.
|
||||
<A HREF=install.html>installation methods</A>.
|
||||
The feeling from
|
||||
the author is that this will not be a problem since most of the features pay
|
||||
for themselves both in terms of space (certainly the generic decompression
|
||||
|
|
@ -387,4 +387,3 @@ available via a command from the menu interface).<P>
|
|||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue