<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-grub" role="wrap">
  <?dbhtml filename="grub.html"?>

  <sect1info condition="script">
    <productname>grub</productname>
    <productnumber>&grub-version;</productnumber>
    <address>&grub-url;</address>
  </sect1info>

  <title>GRUB-&grub-version;</title>

  <indexterm zone="ch-system-grub">
    <primary sortas="a-Grub">GRUB</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

	<para>GRUB 软件包包含 <quote>大统一</quote> （GRand Unified）
	启动引导器。</para>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&grub-ch6-sbu;</seg>
        <seg>&grub-ch6-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>安装 GRUB</title>

    <para>准备安装 GRUB：</para>

<screen><userinput remap="configure">./configure --prefix=/usr          \
            --sbindir=/sbin        \
            --sysconfdir=/etc      \
            --disable-efiemu       \
            --disable-werror</userinput></screen>

    <variablelist>
      <title>新的配置选项的含义：</title>

      <varlistentry>
        <term><parameter>--disable-werror</parameter></term>
        <listitem>
          <para>该选项允许在有较新的 Flex 版本导致的警告时完成构建。</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--disable-efiemu</parameter></term>
        <listitem>
          <para>该选项通过禁用 LFS 不需要的特性和测试程序，
          最小化需要构建的内容。</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para>编译该软件包：</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>该软件包不包含测试套件。</para>

    <para>安装该软件包：</para>

<screen><userinput remap="install">make install</userinput></screen>

  <para>使用 GRUB 引导您的 LFS 系统的方法将在
  <xref linkend="ch-bootable-grub"/> 中讨论。</para>

  </sect2>

  <sect2 id="contents-gRUB" role="content">
    <title>GRUB 的内容</title>

    <segmentedlist>
      <segtitle>安装的程序</segtitle>
      <segtitle>安装的目录</segtitle>

      <seglistitem>

       <seg>grub-bios-setup,      grub-editenv,    grub-file,        grub-fstest,
            grub-glue-efi,        grub-install,    grub-kbdcomp,     grub-macbless,   
            grub-menulst2cfg,     grub-mkconfig,
                                  grub-mkimage,    grub-mklayout,    grub-mknetdir,
            grub-mkpasswd-pbkdf2, grub-mkrelpath,  grub-mkrescue,    grub-mkstandalone,
            grub-ofpathname,      grub-probe,      grub-reboot,      grub-render-label, 
            grub-script-check,
            grub-set-default,     grub-sparc64-setup, 以及 grub-syslinux2cfg</seg>

        <seg>/usr/lib/grub, /etc/grub.d, /usr/share/grub, 以及 boot/grub (
        在初次运行 grub-install 时安装)</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">简要描述</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="grub-bios-setup">
        <term><command>grub-bios-setup</command></term>
        <listitem>
          <para>grub-install 使用的辅助程序</para>
          <indexterm zone="ch-system-grub grub-bios-setup">
            <primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-editenv">
        <term><command>grub-editenv</command></term>
        <listitem>
          <para>用于编辑环境块的工具</para>
          <indexterm zone="ch-system-grub grub-editenv">
            <primary sortas="b-grub-editenv">grub-editenv</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-file">
        <term><command>grub-file</command></term>
        <listitem>
          <para>检验文件是否是给定类型</para>
          <indexterm zone="ch-system-grub grub-file">
            <primary sortas="b-grub-file">grub-file</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-fstest">
        <term><command>grub-fstest</command></term>
        <listitem>
          <para>调试文件系统驱动程序的工具</para>
          <indexterm zone="ch-system-grub grub-fstest">
            <primary sortas="b-grub-fstest">grub-fstest</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-glue-efi">
        <term><command>grub-glue-efi</command></term>
        <listitem>
          <para>处理 ia32 和 amd64 EFI 镜像，根据 Apple 格式粘合它们</para>
          <indexterm zone="ch-system-grub grub-glue-efi">
            <primary sortas="b-grub-glue-efi">grub-glue-efi</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-install">
        <term><command>grub-install</command></term>
        <listitem>
          <para>在您的驱动器上安装 GRUB</para>
          <indexterm zone="ch-system-grub grub-install">
            <primary sortas="b-grub-install">grub-install</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-kbdcomp">
        <term><command>grub-kbdcomp</command></term>
        <listitem>
          <para>将 xkb 布局转化为 GRUB 能够识别的格式的脚本</para>
          <indexterm zone="ch-system-grub grub-kbdcomp">
            <primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-macbless">
        <term><command>grub-macbless</command></term>
        <listitem>
          <para>Mac 风格的 bless 命令，用于 HFS 或 HFS+ 文件系统</para>
          <indexterm zone="ch-system-grub grub-macbless">
            <primary sortas="b-grub-macbless">grub-macbless</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-menulst2cfg">
        <term><command>grub-menulst2cfg</command></term>
        <listitem>
          <para>将经典的 GRUB <filename>menu.lst</filename>
          转化为 <filename>grub.cfg</filename> 以供 GRUB 2 使用</para>
          <indexterm zone="ch-system-grub grub-menulst2cfg">
            <primary sortas="b-grub-menulst2cfg">grub-menulst2cfg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkconfig">
        <term><command>grub-mkconfig</command></term>
        <listitem>
          <para>生成 GRUB 配置文件</para>
          <indexterm zone="ch-system-grub grub-mkconfig">
            <primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkimage">
        <term><command>grub-mkimage</command></term>
        <listitem>
          <para>创建 GRUB 可引导镜像</para>
          <indexterm zone="ch-system-grub grub-mkimage">
            <primary sortas="b-grub-mkimage">grub-mkimage</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mklayout">
        <term><command>grub-mklayout</command></term>
        <listitem>
          <para>生成 GRUB 键盘布局文件</para>
          <indexterm zone="ch-system-grub grub-mklayout">
            <primary sortas="b-grub-mklayout">grub-mklayout</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mknetdir">
        <term><command>grub-mknetdir</command></term>
        <listitem>
          <para>准备 GRUB 网络启动目录</para>
          <indexterm zone="ch-system-grub grub-mknetdir">
            <primary sortas="b-grub-mknetdir">grub-mknetdir</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkpasswd-pbkdf2">
        <term><command>grub-mkpasswd-pbkdf2</command></term>
        <listitem>
          <para>生成用于引导菜单的加密 PBKDF2 密码</para>
          <indexterm zone="ch-system-grub grub-mkpasswd-pbkdf2">
            <primary sortas="b-grub-mkpasswd-pbkdf2">grub-mkpasswd-pbkdf2</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkrelpath">
        <term><command>grub-mkrelpath</command></term>
        <listitem>
          <para>生成相对于根目录的系统路径名称</para>
          <indexterm zone="ch-system-grub grub-mkrelpath">
            <primary sortas="b-grub-mkrelpath">grub-mkrelpath</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkrescue">
        <term><command>grub-mkrescue</command></term>
        <listitem>
          <para>为软盘或 CDROM/DVD 创建 GRUB 可引导镜像</para>
          <indexterm zone="ch-system-grub grub-mkrescue">
            <primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-mkstandalone">
        <term><command>grub-mkstandalone</command></term>
        <listitem>
          <para>生成独立（包含所有模块）的镜像</para>
          <indexterm zone="ch-system-grub grub-mkstandalone">
            <primary sortas="b-grub-mkstandalone">grub-mkstandalone</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-ofpathname">
        <term><command>grub-ofpathname</command></term>
        <listitem>
          <para>打印 GRUB 设备路径的帮助程序</para>
          <indexterm zone="ch-system-grub grub-ofpathname">
            <primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-probe">
        <term><command>grub-probe</command></term>
        <listitem>
          <para>对给定路径或设备探测信息</para>
          <indexterm zone="ch-system-grub grub-probe">
            <primary sortas="b-grub-probe">grub-probe</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-reboot">
        <term><command>grub-reboot</command></term>
        <listitem>
          <para>仅为下次启动设置 GRUB 默认引导项</para>
          <indexterm zone="ch-system-grub grub-reboot">
            <primary sortas="b-grub-reboot">grub-reboot</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-render-label">
        <term><command>grub-render-label</command></term>
        <listitem>
          <para>为 Apple Mac 设置 Apple .disk_label</para>
          <indexterm zone="ch-system-grub grub-render-label">
            <primary sortas="b-grub-render-label">grub-render-label</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-script-check">
        <term><command>grub-script-check</command></term>
        <listitem>
          <para>在 GRUB 配置脚本中检查语法错误</para>
          <indexterm zone="ch-system-grub grub-script-check">
            <primary sortas="b-grub-script-check">grub-script-check</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-set-default">
        <term><command>grub-set-default</command></term>
        <listitem>
          <para>设置 GRUB 默认引导项</para>
          <indexterm zone="ch-system-grub grub-set-default">
            <primary sortas="b-grub-set-default">grub-set-default</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-sparc64-setup">
        <term><command>grub-sparc64-setup</command></term>
        <listitem>
          <para>grub-setup 使用的帮助程序</para>
          <indexterm zone="ch-system-grub grub-sparc64-setup">
            <primary sortas="b-grub-sparc64-setup">grub-setup</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="grub-syslinux2cfg">
        <term><command>grub-syslinux2cfg</command></term>
        <listitem>
          <para>将 syslinux 配置文件转换为 grub.cfg 格式</para>
          <indexterm zone="ch-system-grub grub-syslinux2cfg">
            <primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>
