| 1 |
'\" t |
| 2 |
.\" @(#)mkrescue.8 |
| 3 |
.\" This page is part of the LILO package, which is released by |
| 4 |
.\" the author(s) under a BSD license. See the file COPYING |
| 5 |
.\" in the LILO source directory for the license and disclaimer. |
| 6 |
.\" |
| 7 |
.\" Original for lilo 22.1, John Coffman 2001-10-31 |
| 8 |
.\" Updated for lilo 22.5.4, John Coffman 2003-05-24 |
| 9 |
.\" Updated for lilo 22.6.1, John Coffman 2004-11-16 |
| 10 |
.\" Updated for lilo 23.1, Martin Eberhard Schauer 2011-03-06 |
| 11 |
.\" (Reformatted to better match Linux man-pages conventions) |
| 12 |
|
| 13 |
.TH MKRESCUE 8 "6 Mar 2011" |
| 14 |
|
| 15 |
.SH NAME |
| 16 |
mkrescue \- make rescue floppy or CD |
| 17 |
|
| 18 |
.SH SYNOPSIS |
| 19 |
.B /sbin/mkrescue |
| 20 |
makes a bootable rescue floppy or CD using the default kernel specified in |
| 21 |
.IR lilo.conf . |
| 22 |
|
| 23 |
.SH DESCRIPTION |
| 24 |
\fBmkrescue\fP takes its specifation for the kernel from the default image |
| 25 |
specified in \fI/etc/lilo.conf\fP. |
| 26 |
If the actual default is an \fIother=\fP specification, then use the first |
| 27 |
\fIimage=\fP specification. |
| 28 |
Any associated initial ramdisk (\fIinitrd=\fP), and \fIappend=\fP options |
| 29 |
will also be used. |
| 30 |
The root directory will be taken to be the \fIcurrent\fP root. |
| 31 |
A bootable floppy or CD-image will be created using LILO version |
| 32 |
22.5.5 or later. |
| 33 |
\fBmkrescue\fP normally requires no options, unless a CD-image is desired |
| 34 |
(\fB--iso\fP). |
| 35 |
|
| 36 |
.SH OPTIONS |
| 37 |
|
| 38 |
.TP |
| 39 |
\fB--append\fP <string> |
| 40 |
Override any \fIappend=\fP options taken from the default image. |
| 41 |
If there is any doubt about whether the \fIlilo.conf\fP |
| 42 |
options are correct, then specify no kernel parameters by providing the |
| 43 |
null string (\fB--append ""\fP). |
| 44 |
|
| 45 |
.TP |
| 46 |
.B --debug |
| 47 |
Provide verbose output of the operation of |
| 48 |
.BR mkrescue , |
| 49 |
pausing to allow the setting of internal operating parameters to be viewed. |
| 50 |
<CR> must be hit to proceed from these pauses. |
| 51 |
|
| 52 |
.TP |
| 53 |
\fB--device\fP <device> |
| 54 |
Make the floppy on a device other than \fI/dev/fd0\fP. |
| 55 |
The floppy disk will always be made to boot on BIOS device code 0x00 (A: |
| 56 |
drive), without regard to the drive on which it is created. |
| 57 |
|
| 58 |
.TP |
| 59 |
.B --fast |
| 60 |
Use a faster method of creating the boot floppy. |
| 61 |
This involves first creating a file of \fB--size\fP 1k blocks (default |
| 62 |
is 1440) mounted using a loopback device, creating the bootable floppy, |
| 63 |
then copying the entire file to the disk. |
| 64 |
|
| 65 |
.TP |
| 66 |
\fB--fs\fP [ \fIext2\fP | \fImsdos\fP | \fIminix\fP ] |
| 67 |
Specify the type of filesystem to create on the drive. |
| 68 |
\fIext2\fP is the default, but \fImsdos\fP and \fIminix\fP allow |
| 69 |
slightly more disk sectors for really big kernels. |
| 70 |
|
| 71 |
.TP |
| 72 |
.B --help |
| 73 |
Print a short usage synopsis, including a list of command options. |
| 74 |
|
| 75 |
.TP |
| 76 |
\fB--image\fP <label> |
| 77 |
Specifies the label or alias of the particular image from which the |
| 78 |
append, initial ramdisk, root, keytable, and kernel information is to |
| 79 |
be taken. |
| 80 |
|
| 81 |
.TP |
| 82 |
\fB--initrd\fP \fI<filepath>\fP and \fB--kernel\fP \fI<filepath>\fP |
| 83 |
These options, which must be used together, allow specification of an |
| 84 |
arbitrary kernel file and initial ramdisk file to be used on the created |
| 85 |
boot floppy. |
| 86 |
Be sure you know what you are doing before you use these options. |
| 87 |
If no inital ramdisk is needed with a particular kernel, then you MUST |
| 88 |
specify \fB--initrd ""\fP, meaning a null pathname. |
| 89 |
|
| 90 |
.TP |
| 91 |
\fB--install\fP [ \fItext\fP | \fImenu\fP ] |
| 92 |
Allows overriding the default human interface used with the rescue |
| 93 |
bootloader (configuration file "install=" option). \fItext\fP is the |
| 94 |
default on 1.2MB and 1.44MB floppy disks, and \fImenu\fP is the default |
| 95 |
on 2.88MB floppies and HD emulation on CD-R media. |
| 96 |
|
| 97 |
.TP |
| 98 |
.BI --iso |
| 99 |
Create an ISO-9660 bootable CD image (El Torito Format) suitable for |
| 100 |
burning to a CD-R or CD-RW. The \fB--device\fP specification defaults to |
| 101 |
the filename \fIrescue.iso\fP, and the \fB--size\fP defaults to 2880. |
| 102 |
A utility such as "wodim" may be used to burn the ISO file to a |
| 103 |
recordable CD medium. |
| 104 |
With this ISO option, the \fB--size\fP \fIHD\fP option is allowed. |
| 105 |
|
| 106 |
.TP |
| 107 |
.BI --nocompact |
| 108 |
For faster kernel loading from a floppy, LILO map compaction is normally |
| 109 |
enabled. |
| 110 |
This option will disable map compaction by omitting the lilo \fB-c\fP |
| 111 |
switch. |
| 112 |
|
| 113 |
.TP |
| 114 |
.BI --noformat |
| 115 |
Suppresses creation of a new filesystem on the boot floppy. |
| 116 |
This option may be used ONLY |
| 117 |
when you know that the floppy you will be writing upon is formatted with the |
| 118 |
same filesystem as specified by \fB--fs\fP \fIXXX\fP (default is \fIext2\fP). |
| 119 |
|
| 120 |
.TP |
| 121 |
\fB--root\fP \fI<device>\fP |
| 122 |
Specify the root filesystem for the kernel on the boot floppy. |
| 123 |
The currently mounted root is taken as the default specification. |
| 124 |
|
| 125 |
.TP |
| 126 |
\fB--size\fP [ \fI1440\fP | \fI1200\fP | \fI2880\fP | \fIHD\fP ] |
| 127 |
The default floppy disk size is \fI1440\fP, meaning a 1.44MB floppy. |
| 128 |
When \fB--iso\fP is specified, the default size is \fI2880\fP. |
| 129 |
Allowed specifications are \fI1200\fP, \fI1440\fP, or \fI2880\fP, meaning |
| 130 |
a 1.2MB, 1.44MB or 2.88MB floppy, respectively. |
| 131 |
No other floppy disk sizes are supported. |
| 132 |
.sp |
| 133 |
The \fIHD\fP specification, meaning "hard disk", may only be used with |
| 134 |
the \fB--iso\fP option, to indicate a 16MB hard disk is to be generated |
| 135 |
for emulation. |
| 136 |
This allows for very large kernel/initial ramdisk combinations on CD-R. |
| 137 |
The hard disk image is created using loopback devices \fI/dev/loop0\fP |
| 138 |
and \fI/dev/loop1\fP, which must be free to utilize this size option. |
| 139 |
|
| 140 |
.TP |
| 141 |
.BI --version |
| 142 |
Print the version number of \fBmkrescue\fP, then terminate. |
| 143 |
|
| 144 |
.SH "SEE ALSO" |
| 145 |
.BR cdrecord (1), |
| 146 |
.BR dd (1), |
| 147 |
.BR wodim (1), |
| 148 |
.BR lilo.conf (5), |
| 149 |
.BR lilo (8), |
| 150 |
.BR mkfs (8), |
| 151 |
.BR mkinitrd (8), |
| 152 |
.BR mkisofs (8), |
| 153 |
.BR mount (8) |
| 154 |
|
| 155 |
.\" .SH "AUTHOR" |
| 156 |
.\" John Coffman <[email protected]> |