Adding upstream version 4.01+dfsg.
[syslinux-debian/hramrach.git] / man / extlinux.1
blob3192122a8bc35a283effab1b38138bb50a0a4be0
1 .TH extlinux "1" "18 December 2007" "SYSLINUX for ext2/ext3 filesystem"
2 .SH NAME
3 extlinux \- install the \s-1SYSLINUX\s+1 bootloader on a ext2/ext3 filesystem
4 .SH SYNOPSIS
5 .B extlinux
6 [\fIoptions\fP] \fIdirectory\fP
7 .SH DESCRIPTION
8 \fBEXTLINUX\fP is a new syslinux derivative, which boots from a Linux ext2/ext3
9 filesystem.  It works the same way as \fBSYSLINUX\fP, with a few slight modifications.
10 It is intended to simplify first-time installation of Linux, and for creation of
11 rescue and other special-purpose boot disks.
12 .PP
13 The installer is designed to be run on a mounted directory.  For example, if you have an
14 ext2 or ext3 usb key mounted on /mnt, you can run the following command:
15 .IP
16 .B extlinux --install /mnt
17 .SH OPTIONS
18 .TP
19 \fB\-H\fR, \fB\-\-heads\fR=#
20 Force the number of heads.
21 .TP
22 \fB\-i\fR, \fB\-\-install\fR
23 Install over the current bootsector.
24 .TP
25 \fB\-O\fR, \fB\-\-clear\-once\fR
26 Clear the boot-once command.
27 .TP
28 \fB\-o\fR, \fB\-\-once\fR=\fIcommand\fR
29 Execute a command once upon boot.
30 .TP
31 \fB\-M\fR, \fB\-\-menu\-save\fR=\fIlabel\fR
32 Set the label to select as default on the next boot
33 .TP
34 \fB\-r\fR, \fB\-\-raid\fR
35 Fall back to the next device on boot failure.
36 .TP
37 \fB\-\-reset\-adv\fR
38 Reset auxiliary data.
39 .TP
40 \fB\-S\fR, \fB\-\-sectors\fR=\fI#\fR
41 Force the number of sectors per track.
42 .TP
43 \fB\-U\fR, \fB\-\-update\fR
44 Updates a previous \fBEXTLINUX\fP installation.
45 .TP
46 \fB\-z\fR, \fB\-\-zip\fR
47 Force zipdrive geometry (-H 64 -S 32).
48 .SH FILES
49 The extlinux configuration file needs to be named extlinux.conf and needs to be stored in the extlinux installation directory. For more information about the contents of extlinux.conf, see syslinux(1) manpage, section files.
50 .SH BUGS
51 I would appreciate hearing of any problems you have with \s-1SYSLINUX\s+1.  I
52 would also like to hear from you if you have successfully used \s-1SYSLINUX\s+1,
53 especially if you are using it for a distribution.
54 .PP
55 If you are reporting problems, please include all possible information
56 about your system and your BIOS; the vast majority of all problems
57 reported turn out to be BIOS or hardware bugs, and I need as much
58 information as possible in order to diagnose the problems.
59 .PP
60 There is a mailing list for discussion among \s-1SYSLINUX\s+1 users and for
61 announcements of new and test versions. To join, send a message to
62 majordomo@linux.kernel.org with the line:
63 .SH SEE ALSO
64 .BR syslinux (1)