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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
.\" -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH vmelilo 8 "__DATE__" "Version __VERSION__"
.\" 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)
.SH NAME
vmelilo \- m68k VME Linux Loader
.SH SYNOPSIS
.B vmelilo
.RI [ options ]
.SH DESCRIPTION
.B vmelilo
is used to install an m68k VME Linux boot block loader on a boot partition.
It can also be used to save boot blocks to a file or restore boot blocks from
a file. By default
.B vmelilo
will detect the machine type it is running on and will
install an appropriate boot loader.
.SH PREREQUISITES
BVMBug Revision
.B G
or later boot ROMs for BVME4000/6000.
.SH OPTIONS
.TP
.B \-h, \-\-help
Display the usage information.
.TP
.B \-v, \-\-verbose
Enable verbose mode.
.TP
.B \-q, \-\-quiet
Operate silently.
.TP
.B \-f, \-\-force
Force installation and restore over an unknown boot block.
.TP
.B \-a, \-\-arch id
Override automatic machine type detection to allow disk initialisation on
a foreign system. Also allows the machine type to be specified when
'/proc/hardware' does not show the appropriate model.
Where
.B id
is:
.sp
.B bvme
\- BVME4000/6000
.br
.B mvme
\- Motorola MVME 147/162/166/167/172/177
.TP
.B \-w, \-\-root prefix
Use another root directory instead of /.
.TP
.B \-B, \-\-force-backup
Force a boot block backup even if a boot block backup file exists.
.TP
.B \-b, \-\-backup\-file file
Write boot block backup to
.I file
instead of /boot/backup.xx.yy.
Specify /dev/null if no boot block backup is required.
.TP
.B \-u, \-\-uninstall
Uninstall by restoring the backed up boot block from
/boot/backup.xx.yy.
.TP
.B \-r, \-\-restore\-from file
Restore the boot block from
.I file.
.TP
.B \-s, \-\-save\-to file
Just save the boot block to
.I file.
.TP
.B \-d, \-\-device device
Override block special device in configuration file.
.TP
.B \-c, \-\-config\-file file
Read configuration settings from file instead of /etc/vmelilo.conf. If file
is '\-' the configuration data is read from standard input.
.TP
.B \-l, \-\-loader\-file file
Write boot loader code to
.I file
instead of /boot/boot.loader.
.TP
.B \-t, \-\-test
Test mode, don't actually write boot block.
.TP
.B \-V, \-\-version
Display the version information.
.SH FILES
.TP
.B /etc/vmelilo.conf
Configuration file.
.TP
.B /boot/backup.xx.yy
Boot block backup, created by
.I vmelilo.
xx and yy are replaced by the device major and minor numbers
respectively.
.TP
.B /boot/boot.loader
Default loader executable, created by
.I vmelilo.
.SH LILO Boot: prompt
A boot prompt will appear on the serial console, if
.I vmelilo
is not configured to boot automatically, or if you press a key on the keyboard
while the word LILO is being displayed.
.sp
While at the Boot: prompt you can perform the following actions:
.sp
Press <Enter> to boot the default configuration.
.sp
Press <Tab> to list the available boot configurations.
.sp
Enter
.B ?
or
.B help
to get a list of valid commands.
.sp
Enter the label or alias of a configuration to boot followed by any kernel command
line parameters. These command line parameters will be appended to the kernel command
line
.B after
the
.I vmelilo.conf
\'cmdline', 'root', 'console', 'read\-write' and
\'read\-only' option values, so duplicate command line values entered at the Boot:
prompt
will take precedence. The parameters specified by the
.I vmelilo.conf
\'append' option are tagged on the end of the kernel command line, so they can't be
overridden.
If the record has a password attached to it, the loader will prompt
for it first and will only boot if you enter the correct password.
If the configuration is a 'restricted' configuration you will be prompted for the
password only if extra kernel command line parameters have been entered.
.sp
Enter
.B su
to enter the boot monitor. If a master password has been set the loader will ask for
it before allowing you to enter the boot monitor.
.sp
Sit and wait: after the specified timeout the loader will
boot the default configuration automatically. If the timeout has been set to zero
(infinite) you will have a long wait.
.SH AUTHOR
Nick Holgate <holgate@debian.org>
.SH ACKNOWLEDGMENTS
Some parts of this program were derived directly from original code and
ideas from Geert Uytterhoeven <Geert.Uytterhoeven@cs.kuleuven.ac.be> and
Roman Hodek <Roman.Hodek@informatik.uni\-erlangen.de>.
.PP
The original idea for this program comes from the Linux distribution:
.TP
.B LILO
Generic Boot Loader for Linux ("LInux LOader") by Werner Almesberger
.SH SEE ALSO
vmelilo.conf(5)
|
