Provided by: extlinux_6.04~git20190206.bf6db5b4+dfsg1-2_amd64 bug

NAME

       extlinux - install the SYSLINUX bootloader on an ext2/ext3/ext4/btrfs/xfs filesystem

SYNOPSIS

       extlinux [options] directory

DESCRIPTION

       EXTLINUX  is  a  new syslinux derivative, which boots from a Linux ext2/ext3/ext4/btrfs or
       xfs filesystem.  It works the same way as SYSLINUX, with a few slight  modifications.   It
       is  intended  to simplify first-time installation of Linux, and for creation of rescue and
       other special-purpose boot disks.

       The installer is designed to be run on a mounted directory.  For example, if you  have  an
       ext2, ext3, ext4, or btrfs usb key mounted on /mnt, you can run the following command:

              extlinux --install /mnt

OPTIONS

       -H, --heads=#
              Force the number of heads.

       -i, --install
              Install over the current bootsector.

       -O, --clear-once
              Clear the boot-once command.

       -o, --once=command
              Execute a command once upon boot.

       -M, --menu-save=label
              Set the label to select as default on the next boot

       -r, --raid
              Fall back to the next device on boot failure.

       --reset-adv
              Reset auxiliary data.

       -S, --sectors=#
              Force the number of sectors per track.

       -U, --update
              Updates a previous EXTLINUX installation.

       -z, --zip
              Force zipdrive geometry (-H 64 -S 32).

       --device=devicename
              Override  the  automatic  detection  of  device names.  This option is intended for
              special environments only and should not be used by normal users.  Misuse  of  this
              option can cause disk corruption and lost data.

FILES

       The  extlinux configuration file needs to be named syslinux.cfg or 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.

LIMITATIONS

       Booting  from  XFS  only  works  when an MBR partition table is used (not on GPT partition
       tables).

BUGS

       I would appreciate hearing of any problems you have with SYSLINUX.  I would also  like  to
       hear from you if you have successfully used SYSLINUX, especially if you are using it for a
       distribution.

       If you are reporting problems, please include all possible information about  your  system
       and  your BIOS; the vast majority of all problems reported turn out to be BIOS or hardware
       bugs, and I need as much information as possible in order to diagnose the problems.

       There is a mailing list ⟨syslinux@zytor.com⟩ for discussion among SYSLINUX users  and  for
       announcements  of  new and test versions.  You can subscribe to this mailing list ⟨http://
       www.zytor.com/mailman/listinfo/syslinux⟩.

SEE ALSO

       syslinux(1)