man/extlinux.1

   1 .TH extlinux "1" "18 December 2007" "SYSLINUX for ext/btrfs/xfs filesystems"
   2 .SH NAME
   3 extlinux \- install the \s-1SYSLINUX\s+1 bootloader on an ext2/ext3/ext4/btrfs/xfs 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/ext4/btrfs or xfs
   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, ext3, ext4, or btrfs 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 LIMITATIONS
  60 Booting from XFS only works when an MBR partition table is used (not on GPT
  61 partition tables).
  62 .SH BUGS
  63 I would appreciate hearing of any problems you have with \s-1SYSLINUX\s+1.  I
  64 would also like to hear from you if you have successfully used \s-1SYSLINUX\s+1,
  65 especially if you are using it for a distribution.
  66 .PP
  67 If you are reporting problems, please include all possible information
  68 about your system and your BIOS; the vast majority of all problems
  69 reported turn out to be BIOS or hardware bugs, and I need as much
  70 information as possible in order to diagnose the problems.
  71 .PP
  72 There is a
  73 .MT syslinux@\:zytor.com
  74 mailing list
  75 .ME
  76 for discussion among \s-1SYSLINUX\s+1 users and for announcements of new and
  77 test versions.  You can
  78 .UR http://\:www.zytor.com/\:mailman/\:listinfo/\:syslinux
  79 subscribe to this mailing list
  80 .UE .
  81 .SH SEE ALSO
  82 .BR syslinux (1)