| 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 | .TP |
|---|
| 49 | \fB\-\-device\fR=\fIdevicename\fR |
|---|
| 50 | Override the automatic detection of device names. This option is |
|---|
| 51 | intended for special environments only and should not be used by |
|---|
| 52 | normal users. Misuse of this option can cause disk corruption and |
|---|
| 53 | lost data. |
|---|
| 54 | .SH FILES |
|---|
| 55 | The extlinux configuration file needs to be named syslinux.cfg or |
|---|
| 56 | extlinux.conf and needs to be stored in the extlinux installation |
|---|
| 57 | directory. For more information about the contents of extlinux.conf, |
|---|
| 58 | see syslinux(1) manpage, section files. |
|---|
| 59 | .SH BUGS |
|---|
| 60 | I would appreciate hearing of any problems you have with \s-1SYSLINUX\s+1. I |
|---|
| 61 | would also like to hear from you if you have successfully used \s-1SYSLINUX\s+1, |
|---|
| 62 | especially if you are using it for a distribution. |
|---|
| 63 | .PP |
|---|
| 64 | If you are reporting problems, please include all possible information |
|---|
| 65 | about your system and your BIOS; the vast majority of all problems |
|---|
| 66 | reported turn out to be BIOS or hardware bugs, and I need as much |
|---|
| 67 | information as possible in order to diagnose the problems. |
|---|
| 68 | .PP |
|---|
| 69 | There is a mailing list for discussion among \s-1SYSLINUX\s+1 users and for |
|---|
| 70 | announcements of new and test versions. To join, send a message to |
|---|
| 71 | majordomo@linux.kernel.org with the line: |
|---|
| 72 | .SH SEE ALSO |
|---|
| 73 | .BR syslinux (1) |
|---|
