2 .\" @(#)mkrescue.8 1.0 20011031 jrc
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 version, John Coffman 2001-10-31
8 .\" Updated to version 2.0 & lilo 22.5.4, John Coffman 2003-05-24
10 .\" Updated to version 3.0 & lilo 22.6.1, John Coffman 2004-11-16
12 .TH MKRESCUE 8 "16 Nov 2004"
14 mkrescue \- make rescue floppy
17 .B "/usr/sbin/mkrescue"
18 \- make a bootable rescue floppy or CD using the default kernel specified
23 takes its specification for the kernel from the default image specified in
24 \fB/etc/lilo.conf\fP. If the actual default is an \fIother=\fP specification,
25 then use the first \fIimage=\fP specification.
26 Any associated initial ramdisk (initrd=), and \fIappend=\fP
27 options will also be used. The root directory will be taken to be the
28 \fIcurrent\fP root. A bootable floppy or CD-image will be created using LILO version
31 normally requires no options, unless a CD-image is desired (\fI--iso\fP).
35 .BI "--append <string>"
36 Override any \fIappend=\fP options taken from the default image. If there is
37 any doubt about whether the \fIlilo.conf\fP options are correct, then specify
38 no kernel parameters with: \fB--append ""\fP, the null string.
41 Provide verbose output of the operation of "mkrescue", pausing to allow
42 the setting of internal operating parameters to be viewed. "<CR>" must
43 be hit to proceed from these pauses.
45 .BI "--device <device>"
46 Make the floppy on a device other than /dev/fd0. The floppy disk will
47 always be made to boot on BIOS device code 0x00 (A: drive), without
48 regard to the drive on which it is created.
51 Use a faster method of creating the boot floppy. This involves first
52 creating a file of "\-\-size" 1k blocks (default is 1440)
53 mounted using a loopback device, creating the bootable floppy,
54 then copying the entire file to the disk.
56 .BI "--fs [ ext2 | msdos | minix ]"
57 Specify the type of filesystem to create on the drive.
59 is the default, but "msdos" and "minix" allow slightly more disk sectors
60 for really big kernels.
63 Print a short usage synopsis, including a list of command options.
66 Specifies the label or alias of the particular image from which the
67 append, initial ramdisk, root, keytable, and kernel information is to be
70 .BI "--initrd <filepath>" " and " "--kernel <filepath>"
71 These options, which must be used together, allow specification of an
72 arbitrary kernel file and initial ramdisk file to be used on the created
73 boot floppy. Be sure you know what you are doing before you use these
74 options. If no initial ramdisk is needed with a particular kernel, then you
75 MUST specify \fB--initrd ""\fP, meaning a null pathname.
77 .BI "--install [ text | menu ]"
78 Allows overriding the default human interface used with the rescue
79 bootloader (configuration file "install=" option). "text" is the
80 default on 1.2MB and 1.44MB floppy disks, and "menu" is the default on
81 2.88MB floppies and HD emulation on CD-R media.
84 Create an ISO-9660 bootable CD image (El Torito Format) suitable for burning
85 to a CD-R or CD-RW. The \fB--device\fP specification defaults to the
86 filename \fB"rescue.iso"\fP, and the \fB--size\fP defaults to 2880. A utility
87 such as \fIcdrecord\fP may be used to burn the ISO file to a recordable CD
88 medium. With this ISO option, the
93 For faster kernel loading from a floppy, LILO map compaction is normally
94 enabled. This option will disable map compaction by omitting the
98 Suppresses creation of a new filesystem on the boot floppy. This option may
101 when you know that the floppy you will be writing upon is formatted with the
102 same filesystem as specified by "\-\-fs XXX" (default is ext2).
104 .BI "--root <device>"
105 Specify the root filesystem for the kernel on the boot floppy. The currently
106 mounted root is taken as the default specification.
108 .BI "--size [ 1440 | 1200 | 2880 | HD ]"
109 The default floppy disk size is \fI1440\fP, meaning a 1.44MB floppy. When \fI--iso\fP
110 is specified, the default size is \fI2880\fP. Allowed
111 specifications are 1200, 1440, or 2880, meaning a 1.2MB, 1.44MB or 2.88MB
112 floppy, respectively. No other floppy disk sizes are supported.
116 specification, meaning "hard disk", may only be used with the
118 option, to indicate a 16MB hard disk is to be generated for emulation. This
119 allows for very large kernel / initial ramdisk combinations on CD-R. The
120 hard disk image is created using loopback devices
121 "/dev/loop0" and "/dev/loop1", which
122 must be free to utilize this size option.
125 Print the version number of \fImkrescue\fP, then terminate.
128 lilo(8), lilo.conf(5), mkfs(8), dd(1), mount(8), mkinitrd(8), mkisofs(8),
131 John Coffman <johninsd@san.rr.com> (3.0)