From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page Syslinux and the translation is 68% complete.

Syslinuxブートローダファミリを含むパッケージです。このパッケージは、SYSLINUX (FAT ファイルシステムブートローダ)、EXTLINUX (ext2/3/4btrfs および xfs ファイルシステムブートローダ)、PXELINUX (ネットワーク PXE ブートローダ)、CD/DVD ブートローディングのための ISOLINUX (ISO-9660) を含みます。

EFI への対応はバージョン 6.00 以降で追加されています。[1]


Syslinux パッケージをインストールすることでシステム上にソフトウェアが提供されますが、パッケージに含まれる様々なブートローダのうちいずれも、インストールされたり有効化されることはありません。

USE フラグ

USE flags for sys-boot/syslinux SYSLINUX, PXELINUX, ISOLINUX, EXTLINUX and MEMDISK bootloaders

bios Enable BIOS support
secureboot Automatically sign efi executables using user specified key
uefi Enable UEFI support


root #emerge --ask sys-boot/syslinux

BIOS システム上のセットアップ

これらの手順は BIOS システム向けのものです。(U)EFI については EFI システム上のセットアップをお読みください。

The rest of this section will presume the boot partition is located at /dev/sda1 (which is a common location). If this is not the case be sure to make adjustments as needed.

To use EXTLINUX be sure to install the proper boot sector, then install the boot loader into the partition. If these steps are omitted EXTLINUX will not be operational. This type of a boot sector setup is not needed for the SYSLINUX, PXELINUX and ISOLINUX installations.


MBR (msdos)

これらの手順は MBR (msdos) パーティションレイアウト向けのものです。GPT については、飛ばして GPT セットアップの節を読んでください。

まず、Syslinux によって提供されるブートセクタをインストールしてください。このコマンドには特段の注意を払ってください; count=1 が与えられないと、ディスクの最初の 440 バイトのみではなく、ディスク全体を上書きしてしまうでしょう:

root #dd bs=440 conv=notrunc count=1 if=/usr/share/syslinux/mbr.bin of=/dev/sda

ブートパーティションをアクティブとしてマークしてください。"Boot" 列に * が表示されるでしょう:

root #fdisk /dev/sda
Command (m for help): a
Partition number (1-3): 1
Command (m for help): p
   Device Boot      Start         End      Blocks   Id  System
/dev/sda1   *        2048      133119       65536   83  Linux
/dev/sda2          133120     4327423     2097152   82  Linux swap / Solaris
/dev/sda3         4327424  1953525167   974598872   83  Linux
Command (m for help): w


これらの手順は GPT パーティションレイアウト向けのものです。MBR (msdos) については、MBR (msdos) 向けの節を読んでください。

まず、Syslinux によって提供されるブートセクタをインストールしてください。このコマンドには特段の注意を払ってください; count=1 が与えられないと、ディスクの最初の 440 バイトのみではなく、ディスク全体を上書きしてしまうでしょう:

root #dd bs=440 conv=notrunc count=1 if=/usr/share/syslinux/gptmbr.bin of=/dev/sda

次に、sys-apps/gptfdiskgdisk ユーティリティを実行して、/boot/extlinux が保存されるパーティションの legacy BIOS bootable 属性を有効化してください。

root #gdisk /dev/sda
Command (? for help): x
Expert command (? for help): a
Partition number (1-3): 1
Known attributes are:
0: system partition
1: hide from EFI
2: legacy BIOS bootable
60: read-only
62: hidden
63: do not automount
Attribute value is 0000000000000000. Set fields are:
  No fields set
Toggle which attribute field (0-63, 64 or <Enter> to exit): 2
Have enabled the 'legacy BIOS bootable' attribute.
Attribute value is 0000000000000004. Set fields are:
2 (legacy BIOS bootable)
Toggle which attribute field (0-63, 64 or <Enter> to exit): 
Expert command (? for help): w



extlinux コマンドを使用して /boot/extlinux に必要なファイルをインストールしてください

root #mkdir /boot/extlinux
root #extlinux --install /boot/extlinux
root #ln -snf . /boot/boot
The "boot -> ." symlink is not necessary per se, but for the sake of consistency, it is made so the example configurations are the same for users with /boot on same partition and those with separate partitions.

The Syslinux package contains various modules to enable additional features. Starting with Syslinux version 5, some modules depends on others, so it is a good idea to copy most basic modules regardless of the use case. See Checking dynamic links to verify whether all dependencies are installed.

root #cd /usr/share/syslinux
root #cp menu.c32 memdisk libcom32.c32 libutil.c32 /boot/extlinux


To install ISOLINUX, start off with a base directory in which all the files that need to reside on the CD or DVD are situated. In the base directory, create a subdirectory called isolinux and copy the isolinux.bin file from the Syslinux package into the isolinux folder:

root #mkdir isolinux
root #cp /usr/share/syslinux/isolinux.bin isolinux/

Create the isolinux.cfg file according to the instructions mentioned below.

Next, create two more directories kernel and images in the base directory:

root #mkdir kernel images

Copy the memdisk binary into the kernel directory:

root #cp /usr/share/syslinux/memdisk kernel/
In order to use the mkisofs command the app-cdr/cdrtools package will need to be installed. This can be obtained by running:
root #emerge --ask app-cdr/cdrtools

When the configuration has been made, the following mkisofs command can be used to create the final ISO image (remember to substitute ${BASEDIR} with the same base directory used in the previous commands):

root #mkisofs -o output.iso -b isolinux/isolinux.bin -c isolinux/ -no-emul-boot -boot-load-size 4 -boot-info-table ${BASEDIR}

The file will be automatically created.


With PXELINUX is possible to netboot using images that are shared through a TFTP server. This article will assume there is a TFTP server installed, and its TFTP root directory is located at /var/lib/tftpboot With this setup, copy the PXELINUX loader to the TFTP boot directory and create a configuration directory:

root #cp /usr/share/syslinux/pxelinux.0 /var/lib/tftpboot/pxelinux.0
root #mkdir /var/lib/tftpboot/pxelinux.cfg
When copying the newer lpxelinux.0 instead of pxelinux.0, it is also possible to load the kernel and ramdisk via HTTP and to make use of DNS names in the configuration file.

The config directory can be used to store different configurations for the netbooted clients. When a client tries to boot, the MAC address or the IP address is used to determine the appropriate client config file. First it tries to look for the MAC address, followed by a try on the hexadecimal representation of the client IP. After that a character is stripped from the end of this hexadecimal representation until no more characters are left, or until a configuration file is located. If none of the tries match, the default config file is used.

The hexadecimal representation of an IP can be found by using the gethostip command:

user $gethostip -x

An example config file matching sequence occurs as follows:

For easy maintenance, create configuration files by hostname and symlink to the IP representation. To re-enable the defaults simply delete or rename the symlink.


(FAT) ファイルシステムに SYSLINUX ブートローダをインストールするには、syslinux コマンドを使用してください:

root #syslinux --install /dev/sda1

EFI システム上のセットアップ

EFI は Syslinux 6.00 からサポートされています。

EFI システムパーティション

Create a partition of type EF (MBR) or EF00 (GPT) with a FAT32 file system. It is also possible to use an existing EFI system partition (ESP) if one is present. It is advisable to mount this partition at /boot/efi/.

The following assumes that the system is booted in EFI mode, and that the EFI system partition is located at /dev/sda1.

Boot loader install

In the EFI system partition, create a directory for the Syslinux files. This directory will also contain the configuration files that will be created later.

root #mkdir -p /boot/efi/EFI/syslinux

Copy the syslinux.efi and ldlinux.e64 files along with the other desired .c32 files from /usr/share/syslinux/efi64/ to the new syslinux directory. For example:

root #cd /usr/share/syslinux/efi64
root #cp syslinux.efi ldlinux.e64 menu.c32 libcom32.c32 libutil.c32 /boot/efi/EFI/syslinux

If the system has not been booted in EFI mode, then the Syslinux files need to be copied to the /boot/efi/EFI/Boot directory instead and syslinux.efi needs to be renamed to bootx64.efi. If this is the case then skip the next section concerning the efibootmgr utility.

Making Syslinux known to EFI

Ensure that CONFIG_EFI_VARS is enabled in the kernel. If it was built as a module, ensure that it is loaded into memory. This action can be done using the modprobe utility. After the modules have been loaded create a new boot entry using efibootmgr, adjusting /dev/sda to the disk containing /boot:

root #modprobe efivars
root #efibootmgr -c -d /dev/sda -l '\EFI\syslinux\syslinux.efi' -L SYSLINUX -p 1

efibootmgr will automatically adjust the EFI boot order to put the most recently created entry at the top of the list. If that is undesired, change the boot order with the -o option.

In order for the efibootmgr command to work sys-boot/efibootmgr must be emerged. If needed, do so using the following command:
root #emerge --ask sys-boot/efibootmgr


The configuration file for Syslinux is called syslinux.cfg. For compatibility with existing installs, the following legacy configuration file names are still supported:

  • EXTLINUX: extlinux.conf
  • ISOLINUX: isolinux.cfg

The configuration format, however, is the same. The configuration file must be present in the directory where Syslinux is installed.


以下は、Gentoo の Minimal LiveCD のものと似た単純な "boot:" プロンプトを提供します:

ファイル syslinux.cfg
DEFAULT gentoo
LABEL gentoo
      LINUX /boot/kernel-3.6.11-gentoo


The following configuration provides a simple text menu example. This is done via the vesamenu module. In some cases where vesa is not compatible, the simpler menu module will work. Copy the VESA menu module into the boot filesystem or EFI system partition. BIOS systems should use the following example:

root #cp /usr/share/syslinux/vesamenu.c32 /boot/extlinux/

EFI のシステムでは以下を使用すべきです:

root #cp /usr/share/syslinux/efi64/vesamenu.c32 /boot/efi/EFI/syslinux/
ファイル /boot/extlinux/extlinux.conf
UI vesamenu.c32
LABEL gentoo
      MENU LABEL Gentoo Linux
      LINUX /boot/kernel-3.6.11-gentoo
LABEL gentoo-old
      MENU LABEL Gentoo Linux (previous kernel)
      LINUX /boot/kernel-3.5.7-gentoo
Avoid using the KERNEL parameter for selecting the Linux kernel images, use the LINUX parameter instead. If the KERNEL parameter is used and the image filename ends with a .0 then extlinux will misinterpret it and try to PXE its ending with a screen full of graphical artifacts and nothing else. See the "KERNEL file" section on the SYSLINUX wiki for more information.
In the configuration file, absolute paths will be relative to the filesystem's root, non-absolute paths will be relative to the Syslinux installation directory.


カーネル引数がハードコードされ、かつ initramfs がカーネルイメージに組み込まれているのでない限り、これらはブートローダを通じてカーネルに渡す必要があるかもしれません。これを行うには、APPEND および/または INITRD 引数を使用してください:

ファイル syslinux.cfgカーネル引数を追加する
DEFAULT gentoo
LABEL gentoo
      LINUX /boot/kernel-3.6.11-gentoo
      INITRD /boot/initramfs-3.6.11-gentoo
      APPEND root=/dev/sda1
PARTUUID (ファイルシステム UUID ではない) ラベルへの参照は root=PARTUUID=xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx 形式で追加することができます。


syslinux-5.00 以降、.c32 モジュールは動的リンクを使用します。依存がインストールされているか確認するためには、Syslinux ディレクトリに入って ldd コマンドを使用してください:

root #LD_LIBRARY_PATH=. ldd *.c32

不足している .c32 モジュールがある場合は、それらがディレクトリにコピーされていることを確認してください。



  1. Syslinux 開発チーム。Syslinux 6。2013 年 6 月 20 日リリース。2016 年 3 月 27 日取得。