bootscripts.xml 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331
  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-config-bootscripts" role="wrap" revision="sysv">
  8. <?dbhtml filename="bootscripts.html"?>
  9. <sect1info condition="script">
  10. <productname>bootscripts</productname>
  11. <productnumber>&lfs-bootscripts-version;</productnumber>
  12. <address>&lfs-bootscripts-url;</address>
  13. </sect1info>
  14. <title>LFS-Bootscripts-&lfs-bootscripts-version;</title>
  15. <indexterm zone="ch-config-bootscripts">
  16. <primary sortas="a-Bootscripts">Bootscripts</primary>
  17. </indexterm>
  18. <sect2 role="package">
  19. <title/>
  20. <para>The LFS-Bootscripts package contains a set of scripts to start/stop
  21. the LFS system at bootup/shutdown.
  22. The configuration files and procedures needed to
  23. customize the boot process are described in the following sections.</para>
  24. <segmentedlist>
  25. <segtitle>&buildtime;</segtitle>
  26. <segtitle>&diskspace;</segtitle>
  27. <seglistitem>
  28. <seg>&lfs-bootscripts-ch7-sbu;</seg>
  29. <seg>&lfs-bootscripts-ch7-du;</seg>
  30. </seglistitem>
  31. </segmentedlist>
  32. </sect2>
  33. <sect2 role="installation">
  34. <title>Installation of LFS-Bootscripts</title>
  35. <para>Install the package:</para>
  36. <screen><userinput remap="install">make install</userinput></screen>
  37. </sect2>
  38. <sect2 id="contents-bootscripts" role="content">
  39. <title>Contents of LFS-Bootscripts</title>
  40. <segmentedlist>
  41. <segtitle>Installed scripts</segtitle>
  42. <segtitle>Installed directories</segtitle>
  43. <seglistitem>
  44. <seg>checkfs, cleanfs, console, functions, halt, ifdown,
  45. ifup, localnet, modules, mountfs, mountvirtfs, network, rc, reboot,
  46. sendsignals, setclock, ipv4-static, swap, sysctl, sysklogd, template,
  47. udev, and udev_retry</seg>
  48. <seg>/etc/rc.d, /etc/init.d (symbolic link), /etc/sysconfig,
  49. /lib/services, /lib/lsb (symbolic link)</seg>
  50. </seglistitem>
  51. </segmentedlist>
  52. <variablelist>
  53. <bridgehead renderas="sect3">Short Descriptions</bridgehead>
  54. <?dbfo list-presentation="list"?>
  55. <?dbhtml list-presentation="table"?>
  56. <varlistentry id="checkfs-bootscripts">
  57. <term><command>checkfs</command></term>
  58. <listitem>
  59. <para>Checks the integrity of the file systems before they are mounted
  60. (with the exception of journal and network based file systems)</para>
  61. <indexterm zone="ch-config-bootscripts checkfs-bootscripts">
  62. <primary sortas="d-checkfs">checkfs</primary>
  63. </indexterm>
  64. </listitem>
  65. </varlistentry>
  66. <varlistentry id="cleanfs-bootscripts">
  67. <term><command>cleanfs</command></term>
  68. <listitem>
  69. <para>Removes files that should not be preserved between reboots, such
  70. as those in <filename class="directory">/var/run/</filename> and
  71. <filename class="directory">/var/lock/</filename>; it re-creates
  72. <filename>/var/run/utmp</filename> and removes the possibly present
  73. <filename>/etc/nologin</filename>, <filename>/fastboot</filename>, and
  74. <filename>/forcefsck</filename> files</para>
  75. <indexterm zone="ch-config-bootscripts cleanfs-bootscripts">
  76. <primary sortas="d-cleanfs">cleanfs</primary>
  77. </indexterm>
  78. </listitem>
  79. </varlistentry>
  80. <varlistentry id="console-bootscripts">
  81. <term><command>console</command></term>
  82. <listitem>
  83. <para>Loads the correct keymap table for the desired keyboard layout;
  84. it also sets the screen font</para>
  85. <indexterm zone="ch-config-bootscripts console-bootscripts">
  86. <primary sortas="d-console">console</primary>
  87. </indexterm>
  88. </listitem>
  89. </varlistentry>
  90. <varlistentry id="functions-bootscripts">
  91. <term><command>functions</command></term>
  92. <listitem>
  93. <para>Contains common functions, such as error and status checking,
  94. that are used by several bootscripts</para>
  95. <indexterm zone="ch-config-bootscripts functions-bootscripts">
  96. <primary sortas="d-functions">functions</primary>
  97. </indexterm>
  98. </listitem>
  99. </varlistentry>
  100. <varlistentry id="halt-bootscripts">
  101. <term><command>halt</command></term>
  102. <listitem>
  103. <para>Halts the system</para>
  104. <indexterm zone="ch-config-bootscripts halt-bootscripts">
  105. <primary sortas="d-halt">halt</primary>
  106. </indexterm>
  107. </listitem>
  108. </varlistentry>
  109. <varlistentry id="ifdown-bootscripts">
  110. <term><command>ifdown</command></term>
  111. <listitem>
  112. <para>Stops a network device</para>
  113. <indexterm zone="ch-config-bootscripts ifdown-bootscripts">
  114. <primary sortas="d-ifdown">ifdown</primary>
  115. </indexterm>
  116. </listitem>
  117. </varlistentry>
  118. <varlistentry id="ifup-bootscripts">
  119. <term><command>ifup</command></term>
  120. <listitem>
  121. <para>Initializes a network device</para>
  122. <indexterm zone="ch-config-bootscripts ifup-bootscripts">
  123. <primary sortas="d-ifup">ifup</primary>
  124. </indexterm>
  125. </listitem>
  126. </varlistentry>
  127. <varlistentry id="localnet-bootscripts">
  128. <term><command>localnet</command></term>
  129. <listitem>
  130. <para>Sets up the system's hostname and local loopback device</para>
  131. <indexterm zone="ch-config-bootscripts localnet-bootscripts">
  132. <primary sortas="d-localnet">localnet</primary>
  133. </indexterm>
  134. </listitem>
  135. </varlistentry>
  136. <varlistentry id="modules-bootscripts">
  137. <term><command>modules</command></term>
  138. <listitem>
  139. <para>Loads kernel modules listed in
  140. <filename>/etc/sysconfig/modules</filename>, using arguments
  141. that are also given there</para>
  142. <indexterm zone="ch-config-bootscripts modules-bootscripts">
  143. <primary sortas="d-modules">modules</primary>
  144. </indexterm>
  145. </listitem>
  146. </varlistentry>
  147. <varlistentry id="mountfs-bootscripts">
  148. <term><command>mountfs</command></term>
  149. <listitem>
  150. <para>Mounts all file systems, except ones that are marked
  151. <emphasis>noauto</emphasis> or are network based</para>
  152. <indexterm zone="ch-config-bootscripts mountfs-bootscripts">
  153. <primary sortas="d-mountfs">mountfs</primary>
  154. </indexterm>
  155. </listitem>
  156. </varlistentry>
  157. <varlistentry id="mountvirtfs-bootscripts">
  158. <term><command>mountvirtfs</command></term>
  159. <listitem>
  160. <para>Mounts virtual kernel file systems, such as <systemitem
  161. class="filesystem">proc</systemitem></para>
  162. <indexterm zone="ch-config-bootscripts mountvirtfs-bootscripts">
  163. <primary sortas="d-mountvirtfs">mountvirtfs</primary>
  164. </indexterm>
  165. </listitem>
  166. </varlistentry>
  167. <varlistentry id="network-bootscripts">
  168. <term><command>network</command></term>
  169. <listitem>
  170. <para>Sets up network interfaces, such as network cards, and sets up
  171. the default gateway (where applicable)</para>
  172. <indexterm zone="ch-config-bootscripts network-bootscripts">
  173. <primary sortas="d-network">network</primary>
  174. </indexterm>
  175. </listitem>
  176. </varlistentry>
  177. <varlistentry id="rc-bootscripts">
  178. <term><command>rc</command></term>
  179. <listitem>
  180. <para>The master run-level control script; it is responsible for
  181. running all the other bootscripts one-by-one, in a sequence determined
  182. by the name of the symbolic links being processed</para>
  183. <indexterm zone="ch-config-bootscripts rc-bootscripts">
  184. <primary sortas="d-rc">rc</primary>
  185. </indexterm>
  186. </listitem>
  187. </varlistentry>
  188. <varlistentry id="reboot-bootscripts">
  189. <term><command>reboot</command></term>
  190. <listitem>
  191. <para>Reboots the system</para>
  192. <indexterm zone="ch-config-bootscripts reboot-bootscripts">
  193. <primary sortas="d-reboot">reboot</primary>
  194. </indexterm>
  195. </listitem>
  196. </varlistentry>
  197. <varlistentry id="sendsignals-bootscripts">
  198. <term><command>sendsignals</command></term>
  199. <listitem>
  200. <para>Makes sure every process is terminated before the system reboots
  201. or halts</para>
  202. <indexterm zone="ch-config-bootscripts sendsignals-bootscripts">
  203. <primary sortas="d-sendsignals">sendsignals</primary>
  204. </indexterm>
  205. </listitem>
  206. </varlistentry>
  207. <varlistentry id="setclock-bootscripts">
  208. <term><command>setclock</command></term>
  209. <listitem>
  210. <para>Resets the kernel clock to local time in case the hardware clock
  211. is not set to UTC time</para>
  212. <indexterm zone="ch-config-bootscripts setclock-bootscripts">
  213. <primary sortas="d-setclock">setclock</primary>
  214. </indexterm>
  215. </listitem>
  216. </varlistentry>
  217. <varlistentry id="ipv4-static-bootscripts">
  218. <term><command>ipv4-static</command></term>
  219. <listitem>
  220. <para>Provides the functionality needed to assign a static Internet
  221. Protocol (IP) address to a network interface</para>
  222. <indexterm zone="ch-config-bootscripts ipv4-static-bootscripts">
  223. <primary sortas="d-ipv4-static">ipv4-static</primary>
  224. </indexterm>
  225. </listitem>
  226. </varlistentry>
  227. <varlistentry id="swap-bootscripts">
  228. <term><command>swap</command></term>
  229. <listitem>
  230. <para>Enables and disables swap files and partitions</para>
  231. <indexterm zone="ch-config-bootscripts swap-bootscripts">
  232. <primary sortas="d-swap">swap</primary>
  233. </indexterm>
  234. </listitem>
  235. </varlistentry>
  236. <varlistentry id="sysctl-bootscripts">
  237. <term><command>sysctl</command></term>
  238. <listitem>
  239. <para>Loads system configuration values from
  240. <filename>/etc/sysctl.conf</filename>, if that file exists,
  241. into the running kernel</para>
  242. <indexterm zone="ch-config-bootscripts sysctl-bootscripts">
  243. <primary sortas="d-sysctl">sysctl</primary>
  244. </indexterm>
  245. </listitem>
  246. </varlistentry>
  247. <varlistentry id="sysklogd-bootscripts">
  248. <term><command>sysklogd</command></term>
  249. <listitem>
  250. <para>Starts and stops the system and kernel log daemons</para>
  251. <indexterm zone="ch-config-bootscripts sysklogd-bootscripts">
  252. <primary sortas="d-sysklogd">sysklogd</primary>
  253. </indexterm>
  254. </listitem>
  255. </varlistentry>
  256. <varlistentry id="template-bootscripts">
  257. <term><command>template</command></term>
  258. <listitem>
  259. <para>A template to create custom bootscripts for other
  260. daemons</para>
  261. <indexterm zone="ch-config-bootscripts template-bootscripts">
  262. <primary sortas="d-template">template</primary>
  263. </indexterm>
  264. </listitem>
  265. </varlistentry>
  266. <varlistentry id="udev-bootscripts">
  267. <term><command>udev</command></term>
  268. <listitem>
  269. <para>Prepares the <filename class="directory">/dev</filename>
  270. directory and starts Udev</para>
  271. <indexterm zone="ch-config-bootscripts udev-bootscripts">
  272. <primary sortas="d-udev">udev</primary>
  273. </indexterm>
  274. </listitem>
  275. </varlistentry>
  276. <varlistentry id="udev-retry-bootscripts">
  277. <term><command>udev_retry</command></term>
  278. <listitem>
  279. <para>Retries failed udev uevents, and copies generated rules
  280. files from <filename class="directory">/run/udev</filename> to
  281. <filename class="directory">/etc/udev/rules.d</filename> if required</para>
  282. <indexterm zone="ch-config-bootscripts udev-retry-bootscripts">
  283. <primary sortas="d-udev-retry">udev_retry</primary>
  284. </indexterm>
  285. </listitem>
  286. </varlistentry>
  287. </variablelist>
  288. </sect2>
  289. </sect1>