diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /upstream/debian-bookworm/man8/update-grub.8 | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/debian-bookworm/man8/update-grub.8')
-rw-r--r-- | upstream/debian-bookworm/man8/update-grub.8 | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man8/update-grub.8 b/upstream/debian-bookworm/man8/update-grub.8 new file mode 100644 index 00000000..5ebac7be --- /dev/null +++ b/upstream/debian-bookworm/man8/update-grub.8 @@ -0,0 +1,107 @@ +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "update-grub" "8" "June 18, 2001" "Jason Thomas" +.SH "NAME" +update\-grub \- program to generate GRUB's menu.lst file +.SH "SYNOPSIS" +.B update\-grub +.SH "DESCRIPTION" +.B \fBupdate\-grub\fR +is a program used to generate the \fImenu.lst\fR file used by the grub bootloader. +It works by looking in \fI/boot\fR for all files which start with "\fIvmlinuz\-\fR". They will be treated as kernels, and grub menu entries will be created for each. It will also create the initial \fImenu.lst\fR if none exists, after prompting the user. +It will also add initrd lines for ramdisk images found with the same version as kernels found. e.g. /boot/vmlinuz-2.4.5 and /boot/initrd-2.4.5 will cause a line of "initrd=/boot/initrd-2.4.5 or similar to be added for the kernel entry in the menu.lst. + +After \fBupdate\-grub\fR has been run for the first time, the user is required to edit the generated \fBmenu.lst\fR. The user must set the two options \fBupdate\-grub\fR uses. Then re\-run the \fBupdate\-grub\fR script to update the \fImenu.lst\fR file using the default's that have been set. + +These are the options passed to the linux kernel: +.br +# kopt=root=/dev/hda1 ro +.br +Everything after "kopt=" is passed to the kernel as parameters. See bootparam(7) for more information. + +This is the grub device from which grub loads the kernel: +.br +# groot=(hd0,1) +.br +(hd0,1) is a partition in grub notation. See grub(8) for more information. + +This option controls if grub should create the alternative boot options in the menu entries +.br +# alternative=true +.br +# alternative=false + +This option controls if grub should lock the alternative boot options see grub(8) for more information. +.br +# lockalternative=true +.br +# lockalternative=false + +This option controls if grub should lock the old kernels. +.br +# lockold=true +.br +# lockold=false + +This options controls what is used for the alternative boot options, multiple altoptions lines are allowed. +.br +# altoptions=(some description) some kernel command line options +.br +# altoptions=(recovery option) single +.br +The description is placed in '()' and the kernel command line options follow that. +.br +# updatedefault=true +.br +# updatedefault=false + +This option controls if grub should update the default entry to keep +booting the same kernel even if a new one is installed. + + +The \fBupdate\-grub\fR script can be ran automagically from the \fI/etc/kernel\-img.conf\fR file by adding the following lines: + +postinst_hook = update\-grub +.br +postrm_hook = update\-grub +.br +do_bootloader = no + +For further information related to \fI/etc/kernel\-img.conf\fR, see the manpage kernel\-img.conf(5). +.SH "SEE ALSO" +.BR grub (8), +.BR grub\-install (8), +.BR kernel\-img.conf (5) +(contained in the +.B kernel-package +package), +.BR bootparam (7). +.PP +The full documentation for +.B grub +is maintained as a Texinfo manual. If the +.B info +and +.B grub +programs are properly installed at your site, the command +.IP +.B info grub +.PP +should give you access to the complete manual. +You may need to install the +.B grub\-legacy\-doc +package. +.SH "AUTHOR" +This manual page was written by Jason Thomas <jason@debian.org>, +for the Debian GNU/Linux system (but may be used by others). +.\" vim:syn=nroff |