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.
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)
13 .TH MKRESCUE 8 "6 Mar 2011"
16 mkrescue \- make rescue floppy or CD
20 makes a bootable rescue floppy or CD using the default kernel specified in
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
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
33 \fBmkrescue\fP normally requires no options, unless a CD-image is desired
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).
47 Provide verbose output of the operation of
49 pausing to allow the setting of internal operating parameters to be viewed.
50 <CR> must be hit to proceed from these pauses.
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.
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.
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.
73 Print a short usage synopsis, including a list of command options.
77 Specifies the label or alias of the particular image from which the
78 append, initial ramdisk, root, keytable, and kernel information is to
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
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.
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.
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.
108 For faster kernel loading from a floppy, LILO map compaction is normally
110 This option will disable map compaction by omitting the lilo \fB-c\fP
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).
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.
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.
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
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.
142 Print the version number of \fBmkrescue\fP, then terminate.
156 .\" John Coffman <johninsd@san.rr.com>