File: update-menu-lst.8

package info (click to toggle)
pv-grub-menu 1.3
  • links: PTS, VCS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, stretch
  • size: 76 kB
  • ctags: 12
  • sloc: sh: 524; makefile: 3
file content (78 lines) | stat: -rw-r--r-- 3,133 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
.\" 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\-menu\-lst" "8" "August 11, 2013" "Charles Plessy"
.SH "NAME"
update\-menu\-lst \- program to generate PV-GRUB's menu.lst file
.SH "SYNOPSIS"
.B update\-menu\-lst
.SH "DESCRIPTION"
.B \fBupdate\-menu\-lst\fR
is a program used to generate the \fImenu.lst\fR file used by the PV-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\-menu\-lst\fR has been run for the first time, the user may need to edit the generated \fBmenu.lst\fR, in particular the two options \fBupdate\-menu\-lst\fR uses. Then re\-run the \fBupdate\-menu\-lst\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.

.SH "AUTHOR"
\fBupdate\-menu\-lst\fR was derived from \fBupdate\-grub\fR version 0.97-66
by Charles Plessy <plessy@debian.org>.
.
This manual page was derived by Charles Plessy <plessy@debian.org> from
the manual page of update\-grub, written by Jason Thomas <jason@debian.org>,
for the Debian GNU/Linux system (but may be used by others).
.\" vim:syn=nroff