1
0

grub.xml 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  3. "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  4. <!ENTITY % general-entities SYSTEM "../general.ent">
  5. %general-entities;
  6. ]>
  7. <sect1 id="ch-system-grub" role="wrap">
  8. <?dbhtml filename="grub.html"?>
  9. <sect1info condition="script">
  10. <productname>grub</productname>
  11. <productnumber>&grub-version;</productnumber>
  12. <address>&grub-url;</address>
  13. </sect1info>
  14. <title>GRUB-&grub-version;</title>
  15. <indexterm zone="ch-system-grub">
  16. <primary sortas="a-Grub">GRUB</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The GRUB package contains the GRand Unified Bootloader.</para>
  21. <segmentedlist>
  22. <segtitle>&buildtime;</segtitle>
  23. <segtitle>&diskspace;</segtitle>
  24. <seglistitem>
  25. <seg>&grub-ch6-sbu;</seg>
  26. <seg>&grub-ch6-du;</seg>
  27. </seglistitem>
  28. </segmentedlist>
  29. </sect2>
  30. <sect2 role="installation">
  31. <title>Installation of GRUB</title>
  32. <para>Fix an incompatibility between this package and Glibc-&glibc-version;:</para>
  33. <screen><userinput remap="pre">sed -i -e '/gets is a/d' grub-core/gnulib/stdio.in.h</userinput></screen>
  34. <para>Prepare GRUB for compilation:</para>
  35. <screen><userinput remap="configure">./configure --prefix=/usr \
  36. --sysconfdir=/etc \
  37. --disable-grub-emu-usb \
  38. --disable-efiemu \
  39. --disable-werror</userinput></screen>
  40. <para>The --disable-werror option allows the build to complete with
  41. warnings introduced by more recent flex versions. The other --disable
  42. switches minimize what is built by disabling features and testing programs
  43. not needed for LFS.</para>
  44. <para>Compile the package:</para>
  45. <screen><userinput remap="make">make</userinput></screen>
  46. <para>This package does not come with a test suite.</para>
  47. <para>Install the package:</para>
  48. <screen><userinput remap="install">make install</userinput></screen>
  49. <para>Using GRUB to make your LFS system bootable will be discussed in
  50. <xref linkend="ch-bootable-grub"/>.</para>
  51. </sect2>
  52. <sect2 id="contents-gRUB" role="content">
  53. <title>Contents of GRUB</title>
  54. <segmentedlist>
  55. <segtitle>Installed programs</segtitle>
  56. <segtitle>Installed directories</segtitle>
  57. <seglistitem>
  58. <seg>grub-bin2h, grub-bios-setup, grub-editenv, grub-fstest,
  59. grub-install, grub-kbdcomp, grub-menulst2cfg, grub-mkconfig,
  60. grub-mkdevicemap, grub-mkimage, grub-mklayout, grub-mknetdir,
  61. grub-mkpasswd-pbkdf2, grub-mkrelpath, grub-mkrescue, grub-mkstandalone,
  62. grub-ofpathname, grub-probe, grub-reboot, grub-script-check,
  63. grub-set-default, grub-setup, grub-sparc64-setup </seg>
  64. <seg>/usr/lib/grub, /etc/grub.d, /usr/share/grub, /boot/grub</seg>
  65. </seglistitem>
  66. </segmentedlist>
  67. <variablelist>
  68. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  69. <?dbfo list-presentation="list"?>
  70. <?dbhtml list-presentation="table"?>
  71. <varlistentry id="grub-bin2h">
  72. <term><command>grub-bin2h</command></term>
  73. <listitem>
  74. <para>Converts a binary file to a C header</para>
  75. <indexterm zone="ch-system-grub grub-bin2h">
  76. <primary sortas="b-grub-bin2h">grub-bin2h</primary>
  77. </indexterm>
  78. </listitem>
  79. </varlistentry>
  80. <varlistentry id="grub-bios-setup">
  81. <term><command>grub-bios-setup</command></term>
  82. <listitem>
  83. <para>Is a helper program for grub-install</para>
  84. <indexterm zone="ch-system-grub grub-bios-setup">
  85. <primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
  86. </indexterm>
  87. </listitem>
  88. </varlistentry>
  89. <varlistentry id="grub-editenv">
  90. <term><command>grub-editenv</command></term>
  91. <listitem>
  92. <para>A tool to edit the environment block</para>
  93. <indexterm zone="ch-system-grub grub-editenv">
  94. <primary sortas="b-grub-editenv">grub-editenv</primary>
  95. </indexterm>
  96. </listitem>
  97. </varlistentry>
  98. <varlistentry id="grub-fstest">
  99. <term><command>grub-fstest</command></term>
  100. <listitem>
  101. <para>Tool to debug the filesystem driver</para>
  102. <indexterm zone="ch-system-grub grub-fstest">
  103. <primary sortas="b-grub-fstest">grub-fstest</primary>
  104. </indexterm>
  105. </listitem>
  106. </varlistentry>
  107. <varlistentry id="grub-install">
  108. <term><command>grub-install</command></term>
  109. <listitem>
  110. <para>Install GRUB on your drive</para>
  111. <indexterm zone="ch-system-grub grub-install">
  112. <primary sortas="b-grub-install">grub-install</primary>
  113. </indexterm>
  114. </listitem>
  115. </varlistentry>
  116. <varlistentry id="grub-kbdcomp">
  117. <term><command>grub-kbdcomp</command></term>
  118. <listitem>
  119. <para>Script that converts an xkb layout into one recognized by
  120. GRUB</para>
  121. <indexterm zone="ch-system-grub grub-kbdcomp">
  122. <primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary>
  123. </indexterm>
  124. </listitem>
  125. </varlistentry>
  126. <varlistentry id="grub-menulst2cfg">
  127. <term><command>grub-menulst2cfg</command></term>
  128. <listitem>
  129. <para>Converts a GRUB Legacy <filename>menu.lst</filename>
  130. into a <filename>grub.cfg</filename> for use with GRUB 2</para>
  131. <indexterm zone="ch-system-grub grub-menulst2cfg">
  132. <primary sortas="b-grub-menulst2cfg">grub-menulst2cfg</primary>
  133. </indexterm>
  134. </listitem>
  135. </varlistentry>
  136. <varlistentry id="grub-mkconfig">
  137. <term><command>grub-mkconfig</command></term>
  138. <listitem>
  139. <para>Generate a grub config file</para>
  140. <indexterm zone="ch-system-grub grub-mkconfig">
  141. <primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
  142. </indexterm>
  143. </listitem>
  144. </varlistentry>
  145. <varlistentry id="grub-mkdevicemap">
  146. <term><command>grub-mkdevicemap</command></term>
  147. <listitem>
  148. <para>Generate a device map file automatically</para>
  149. <indexterm zone="ch-system-grub grub-mkdevicemap">
  150. <primary sortas="b-grub-mkdevicemap">grub-mkdevicemap</primary>
  151. </indexterm>
  152. </listitem>
  153. </varlistentry>
  154. <varlistentry id="grub-mkimage">
  155. <term><command>grub-mkimage</command></term>
  156. <listitem>
  157. <para>Make a bootable image of GRUB</para>
  158. <indexterm zone="ch-system-grub grub-mkimage">
  159. <primary sortas="b-grub-mkimage">grub-mkimage</primary>
  160. </indexterm>
  161. </listitem>
  162. </varlistentry>
  163. <varlistentry id="grub-mklayout">
  164. <term><command>grub-mklayout</command></term>
  165. <listitem>
  166. <para>Generates a GRUB keyboard layout file</para>
  167. <indexterm zone="ch-system-grub grub-mklayout">
  168. <primary sortas="b-grub-mklayout">grub-mklayout</primary>
  169. </indexterm>
  170. </listitem>
  171. </varlistentry>
  172. <varlistentry id="grub-mknetdir">
  173. <term><command>grub-mknetdir</command></term>
  174. <listitem>
  175. <para>Prepares a GRUB netboot directory</para>
  176. <indexterm zone="ch-system-grub grub-mknetdir">
  177. <primary sortas="b-grub-mknetdir">grub-mknetdir</primary>
  178. </indexterm>
  179. </listitem>
  180. </varlistentry>
  181. <varlistentry id="grub-mkpasswd-pbkdf2">
  182. <term><command>grub-mkpasswd-pbkdf2</command></term>
  183. <listitem>
  184. <para>Generates an encrypted PBKDF2 password for use in the boot
  185. menu</para>
  186. <indexterm zone="ch-system-grub grub-mkpasswd-pbkdf2">
  187. <primary sortas="b-grub-mkpasswd-pbkdf2">grub-mkpasswd-pbkdf2</primary>
  188. </indexterm>
  189. </listitem>
  190. </varlistentry>
  191. <varlistentry id="grub-mkrelpath">
  192. <term><command>grub-mkrelpath</command></term>
  193. <listitem>
  194. <para>Makes a system pathname relative to its root</para>
  195. <indexterm zone="ch-system-grub grub-mkrelpath">
  196. <primary sortas="b-grub-mkrelpath">grub-mkrelpath</primary>
  197. </indexterm>
  198. </listitem>
  199. </varlistentry>
  200. <varlistentry id="grub-mkrescue">
  201. <term><command>grub-mkrescue</command></term>
  202. <listitem>
  203. <para>Make a bootable image of GRUB suitable for a floppy disk or CDROM/DVD</para>
  204. <indexterm zone="ch-system-grub grub-mkrescue">
  205. <primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
  206. </indexterm>
  207. </listitem>
  208. </varlistentry>
  209. <varlistentry id="grub-mkstandalone">
  210. <term><command>grub-mkstandalone</command></term>
  211. <listitem>
  212. <para>Generates a standalone image</para>
  213. <indexterm zone="ch-system-grub grub-mkstandalone">
  214. <primary sortas="b-grub-mkstandalone">grub-mkstandalone</primary>
  215. </indexterm>
  216. </listitem>
  217. </varlistentry>
  218. <varlistentry id="grub-ofpathname">
  219. <term><command>grub-ofpathname</command></term>
  220. <listitem>
  221. <para>Is a helper program that prints the path of a GRUB device</para>
  222. <indexterm zone="ch-system-grub grub-ofpathname">
  223. <primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
  224. </indexterm>
  225. </listitem>
  226. </varlistentry>
  227. <varlistentry id="grub-probe">
  228. <term><command>grub-probe</command></term>
  229. <listitem>
  230. <para>Probe device information for a given path or device</para>
  231. <indexterm zone="ch-system-grub grub-probe">
  232. <primary sortas="b-grub-probe">grub-probe</primary>
  233. </indexterm>
  234. </listitem>
  235. </varlistentry>
  236. <varlistentry id="grub-reboot">
  237. <term><command>grub-reboot</command></term>
  238. <listitem>
  239. <para>Sets the default boot entry for GRUB for the next boot only</para>
  240. <indexterm zone="ch-system-grub grub-reboot">
  241. <primary sortas="b-grub-reboot">grub-reboot</primary>
  242. </indexterm>
  243. </listitem>
  244. </varlistentry>
  245. <varlistentry id="grub-script-check">
  246. <term><command>grub-script-check</command></term>
  247. <listitem>
  248. <para>Checks GRUB configuration script for syntax errors</para>
  249. <indexterm zone="ch-system-grub grub-script-check">
  250. <primary sortas="b-grub-script-check">grub-script-check</primary>
  251. </indexterm>
  252. </listitem>
  253. </varlistentry>
  254. <varlistentry id="grub-set-default">
  255. <term><command>grub-set-default</command></term>
  256. <listitem>
  257. <para>Sets the default boot entry for GRUB</para>
  258. <indexterm zone="ch-system-grub grub-set-default">
  259. <primary sortas="b-grub-set-default">grub-set-default</primary>
  260. </indexterm>
  261. </listitem>
  262. </varlistentry>
  263. <varlistentry id="grub-setup">
  264. <term><command>grub-setup</command></term>
  265. <listitem>
  266. <para>Set up images to boot from a device</para>
  267. <indexterm zone="ch-system-grub grub-setup">
  268. <primary sortas="b-grub-setup">grub-setup</primary>
  269. </indexterm>
  270. </listitem>
  271. </varlistentry>
  272. <varlistentry id="grub-sparc64-setup">
  273. <term><command>grub-sparc64-setup</command></term>
  274. <listitem>
  275. <para>Is a helper program for grub-setup</para>
  276. <indexterm zone="ch-system-grub grub-sparc64-setup">
  277. <primary sortas="b-grub-sparc64-setup">grub-setup</primary>
  278. </indexterm>
  279. </listitem>
  280. </varlistentry>
  281. </variablelist>
  282. </sect2>
  283. </sect1>