Adding manpage from Brian Pellin <bpellin@gmail.com> for extlinux.
[profile/ivi/syslinux.git] / man / extlinux.1
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\-r\fR, \fB\-\-raid\fR
32 Fall back to the next device on boot failure.
33 .TP
34 \fB\-\-reset\-adv\fR
35 Reset auxiliary data.
36 .TP
37 \fB\-S\fR, \fB\-\-sectors\fR=\fI#\fR
38 Force the number of sectors per track.
39 .TP
40 \fB\-U\fR, \fB\-\-update\fR
41 Updates a previous \fBEXTLINUX\fP installation.
42 .TP
43 \fB\-z\fR, \fB\-\-zip\fR
44 Force zipdrive geometry (-H 64 -S 32).
45 .SH BUGS
46 I would appreciate hearing of any problems you have with \s-1SYSLINUX\s+1.  I
47 would also like to hear from you if you have successfully used \s-1SYSLINUX\s+1,
48 especially if you are using it for a distribution.
49 .PP
50 If you are reporting problems, please include all possible information
51 about your system and your BIOS; the vast majority of all problems
52 reported turn out to be BIOS or hardware bugs, and I need as much
53 information as possible in order to diagnose the problems.
54 .PP
55 There is a mailing list for discussion among \s-1SYSLINUX\s+1 users and for
56 announcements of new and test versions. To join, send a message to
57 majordomo@linux.kernel.org with the line:
58 .SH SEE ALSO
59 .BR syslinux (1)