| 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
 | 
|---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 | 
|---|
| 3 |   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
 | 
|---|
| 4 |   <!ENTITY % general-entities SYSTEM "../../general.ent">
 | 
|---|
| 5 |   %general-entities;
 | 
|---|
| 6 | ]>
 | 
|---|
| 7 | 
 | 
|---|
| 8 | <sect1 id="ch-scripts-bootscripts" role="wrap">
 | 
|---|
| 9 |   <?dbhtml filename="bootscripts.html"?>
 | 
|---|
| 10 | 
 | 
|---|
| 11 |   <title>CLFS-Bootscripts-&clfs-bootscripts-version;</title>
 | 
|---|
| 12 | 
 | 
|---|
| 13 |   <indexterm zone="ch-scripts-bootscripts">
 | 
|---|
| 14 |     <primary sortas="a-Bootscripts">Bootscripts</primary>
 | 
|---|
| 15 |   </indexterm>
 | 
|---|
| 16 | 
 | 
|---|
| 17 |   <sect2 role="package">
 | 
|---|
| 18 |     <title/>
 | 
|---|
| 19 | 
 | 
|---|
| 20 |     <para>The CLFS-Bootscripts package contains a set of scripts to
 | 
|---|
| 21 |     start/stop the CLFS system at bootup/shutdown.</para>
 | 
|---|
| 22 | 
 | 
|---|
| 23 |   </sect2>
 | 
|---|
| 24 | 
 | 
|---|
| 25 |   <sect2 role="installation">
 | 
|---|
| 26 |     <title>Installation of CLFS-Bootscripts</title>
 | 
|---|
| 27 | 
 | 
|---|
| 28 |     <para>Install the package:</para>
 | 
|---|
| 29 | 
 | 
|---|
| 30 | <screen><userinput>make install</userinput></screen>
 | 
|---|
| 31 | 
 | 
|---|
| 32 |   </sect2>
 | 
|---|
| 33 | 
 | 
|---|
| 34 |   <sect2 id="contents-bootscripts" role="content">
 | 
|---|
| 35 |     <title>Contents of CLFS-Bootscripts</title>
 | 
|---|
| 36 | 
 | 
|---|
| 37 |     <segmentedlist>
 | 
|---|
| 38 |       <segtitle>Installed scripts</segtitle>
 | 
|---|
| 39 | 
 | 
|---|
| 40 |       <seglistitem>
 | 
|---|
| 41 |         <seg>checkfs, cleanfs, console, functions, halt, ifdown,
 | 
|---|
| 42 |         ifup, localnet, mountfs, mountkernfs, network, rc, reboot, sendsignals,
 | 
|---|
| 43 |         setclock, static, swap, sysklogd, and template.</seg>
 | 
|---|
| 44 |       </seglistitem>
 | 
|---|
| 45 |     </segmentedlist>
 | 
|---|
| 46 | 
 | 
|---|
| 47 |     <variablelist>
 | 
|---|
| 48 |       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
 | 
|---|
| 49 |       <?dbfo list-presentation="list"?>
 | 
|---|
| 50 |       <?dbhtml list-presentation="table"?>
 | 
|---|
| 51 | 
 | 
|---|
| 52 |       <varlistentry id="checkfs-bootscripts">
 | 
|---|
| 53 |         <term><command>checkfs</command></term>
 | 
|---|
| 54 |         <listitem>
 | 
|---|
| 55 |           <para>Checks the integrity of the file systems before they are
 | 
|---|
| 56 |           mounted (with the exception of journal and network based file
 | 
|---|
| 57 |           systems)</para>
 | 
|---|
| 58 |           <indexterm zone="ch-scripts-bootscripts checkfs-bootscripts">
 | 
|---|
| 59 |             <primary sortas="d-checkfs">checkfs</primary>
 | 
|---|
| 60 |           </indexterm>
 | 
|---|
| 61 |         </listitem>
 | 
|---|
| 62 |       </varlistentry>
 | 
|---|
| 63 | 
 | 
|---|
| 64 |       <varlistentry id="cleanfs-bootscripts">
 | 
|---|
| 65 |         <term><command>cleanfs</command></term>
 | 
|---|
| 66 |         <listitem>
 | 
|---|
| 67 |           <para>Removes files that should not be preserved between reboots,
 | 
|---|
| 68 |           such as those in <filename class="directory">/var/run/</filename>
 | 
|---|
| 69 |           and <filename class="directory">/var/lock/</filename>; it re-creates
 | 
|---|
| 70 |           <filename>/var/run/utmp</filename> and removes the possibly present
 | 
|---|
| 71 |           <filename>/etc/nologin</filename>, <filename>/fastboot</filename>,
 | 
|---|
| 72 |           and <filename>/forcefsck</filename> files</para>
 | 
|---|
| 73 |           <indexterm zone="ch-scripts-bootscripts cleanfs-bootscripts">
 | 
|---|
| 74 |             <primary sortas="d-cleanfs">cleanfs</primary>
 | 
|---|
| 75 |           </indexterm>
 | 
|---|
| 76 |         </listitem>
 | 
|---|
| 77 |       </varlistentry>
 | 
|---|
| 78 | 
 | 
|---|
| 79 |       <varlistentry id="console-bootscripts">
 | 
|---|
| 80 |         <term><command>console</command></term>
 | 
|---|
| 81 |         <listitem>
 | 
|---|
| 82 |           <para>Loads the correct keymap table for the desired keyboard
 | 
|---|
| 83 |           layout; it also sets the screen font</para>
 | 
|---|
| 84 |           <indexterm zone="ch-scripts-bootscripts console-bootscripts">
 | 
|---|
| 85 |             <primary sortas="d-console">console</primary>
 | 
|---|
| 86 |           </indexterm>
 | 
|---|
| 87 |         </listitem>
 | 
|---|
| 88 |       </varlistentry>
 | 
|---|
| 89 | 
 | 
|---|
| 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-scripts-bootscripts functions-bootscripts">
 | 
|---|
| 96 |             <primary sortas="d-functions">functions</primary>
 | 
|---|
| 97 |           </indexterm>
 | 
|---|
| 98 |         </listitem>
 | 
|---|
| 99 |       </varlistentry>
 | 
|---|
| 100 | 
 | 
|---|
| 101 |       <varlistentry id="halt-bootscripts">
 | 
|---|
| 102 |         <term><command>halt</command></term>
 | 
|---|
| 103 |         <listitem>
 | 
|---|
| 104 |           <para>Halts the system</para>
 | 
|---|
| 105 |           <indexterm zone="ch-scripts-bootscripts halt-bootscripts">
 | 
|---|
| 106 |             <primary sortas="d-halt">halt</primary>
 | 
|---|
| 107 |           </indexterm>
 | 
|---|
| 108 |         </listitem>
 | 
|---|
| 109 |       </varlistentry>
 | 
|---|
| 110 | 
 | 
|---|
| 111 |       <varlistentry id="ifdown-bootscripts">
 | 
|---|
| 112 |         <term><command>ifdown</command></term>
 | 
|---|
| 113 |         <listitem>
 | 
|---|
| 114 |           <para>Assists the network script with stopping network devices</para>
 | 
|---|
| 115 |           <indexterm zone="ch-scripts-bootscripts ifdown-bootscripts">
 | 
|---|
| 116 |             <primary sortas="d-ifdown">ifdown</primary>
 | 
|---|
| 117 |           </indexterm>
 | 
|---|
| 118 |         </listitem>
 | 
|---|
| 119 |       </varlistentry>
 | 
|---|
| 120 | 
 | 
|---|
| 121 |       <varlistentry id="ifup-bootscripts">
 | 
|---|
| 122 |         <term><command>ifup</command></term>
 | 
|---|
| 123 |         <listitem>
 | 
|---|
| 124 |           <para>Assists the network script with starting network devices</para>
 | 
|---|
| 125 |           <indexterm zone="ch-scripts-bootscripts ifup-bootscripts">
 | 
|---|
| 126 |             <primary sortas="d-ifup">ifup</primary>
 | 
|---|
| 127 |           </indexterm>
 | 
|---|
| 128 |         </listitem>
 | 
|---|
| 129 |       </varlistentry>
 | 
|---|
| 130 | 
 | 
|---|
| 131 |       <varlistentry id="localnet-bootscripts">
 | 
|---|
| 132 |         <term><command>localnet</command></term>
 | 
|---|
| 133 |         <listitem>
 | 
|---|
| 134 |           <para>Sets up the system's hostname and local loopback device</para>
 | 
|---|
| 135 |           <indexterm zone="ch-scripts-bootscripts localnet-bootscripts">
 | 
|---|
| 136 |             <primary sortas="d-localnet">localnet</primary>
 | 
|---|
| 137 |           </indexterm>
 | 
|---|
| 138 |         </listitem>
 | 
|---|
| 139 |       </varlistentry>
 | 
|---|
| 140 | 
 | 
|---|
| 141 |       <varlistentry id="mountfs-bootscripts">
 | 
|---|
| 142 |         <term><command>mountfs</command></term>
 | 
|---|
| 143 |         <listitem>
 | 
|---|
| 144 |           <para>Mounts all file systems, except ones that are marked
 | 
|---|
| 145 |           <emphasis>noauto</emphasis> or are network based</para>
 | 
|---|
| 146 |           <indexterm zone="ch-scripts-bootscripts mountfs-bootscripts">
 | 
|---|
| 147 |             <primary sortas="d-mountfs">mountfs</primary>
 | 
|---|
| 148 |           </indexterm>
 | 
|---|
| 149 |         </listitem>
 | 
|---|
| 150 |       </varlistentry>
 | 
|---|
| 151 | 
 | 
|---|
| 152 |       <varlistentry id="mountkernfs-bootscripts">
 | 
|---|
| 153 |         <term><command>mountkernfs</command></term>
 | 
|---|
| 154 |         <listitem>
 | 
|---|
| 155 |           <para>Mounts virtual kernel file systems, such as
 | 
|---|
| 156 |           <systemitem class="filesystem">proc</systemitem></para>
 | 
|---|
| 157 |           <indexterm zone="ch-scripts-bootscripts mountkernfs-bootscripts">
 | 
|---|
| 158 |             <primary sortas="d-mountkernfs">mountkernfs</primary>
 | 
|---|
| 159 |           </indexterm>
 | 
|---|
| 160 |         </listitem>
 | 
|---|
| 161 |       </varlistentry>
 | 
|---|
| 162 | 
 | 
|---|
| 163 |       <varlistentry id="network-bootscripts">
 | 
|---|
| 164 |         <term><command>network</command></term>
 | 
|---|
| 165 |         <listitem>
 | 
|---|
| 166 |           <para>Sets up network interfaces, such as network cards, and sets up
 | 
|---|
| 167 |           the default gateway (where applicable)</para>
 | 
|---|
| 168 |           <indexterm zone="ch-scripts-bootscripts network-bootscripts">
 | 
|---|
| 169 |             <primary sortas="d-network">network</primary>
 | 
|---|
| 170 |           </indexterm>
 | 
|---|
| 171 |         </listitem>
 | 
|---|
| 172 |       </varlistentry>
 | 
|---|
| 173 | 
 | 
|---|
| 174 |       <varlistentry id="rc-bootscripts">
 | 
|---|
| 175 |         <term><command>rc</command></term>
 | 
|---|
| 176 |         <listitem>
 | 
|---|
| 177 |           <para>The master run-level control script; it is responsible for
 | 
|---|
| 178 |           running all the other bootscripts one-by-one, in a sequence
 | 
|---|
| 179 |           determined by the name of the symbolic links being processed</para>
 | 
|---|
| 180 |           <indexterm zone="ch-scripts-bootscripts rc-bootscripts">
 | 
|---|
| 181 |             <primary sortas="d-rc">rc</primary>
 | 
|---|
| 182 |           </indexterm>
 | 
|---|
| 183 |         </listitem>
 | 
|---|
| 184 |       </varlistentry>
 | 
|---|
| 185 | 
 | 
|---|
| 186 |       <varlistentry id="reboot-bootscripts">
 | 
|---|
| 187 |         <term><command>reboot</command></term>
 | 
|---|
| 188 |         <listitem>
 | 
|---|
| 189 |           <para>Reboots the system</para>
 | 
|---|
| 190 |           <indexterm zone="ch-scripts-bootscripts reboot-bootscripts">
 | 
|---|
| 191 |             <primary sortas="d-reboot">reboot</primary>
 | 
|---|
| 192 |           </indexterm>
 | 
|---|
| 193 |         </listitem>
 | 
|---|
| 194 |       </varlistentry>
 | 
|---|
| 195 | 
 | 
|---|
| 196 |       <varlistentry id="sendsignals-bootscripts">
 | 
|---|
| 197 |         <term><command>sendsignals</command></term>
 | 
|---|
| 198 |         <listitem>
 | 
|---|
| 199 |           <para>Makes sure every process is terminated before the system reboots
 | 
|---|
| 200 |           or halts</para>
 | 
|---|
| 201 |           <indexterm zone="ch-scripts-bootscripts sendsignals-bootscripts">
 | 
|---|
| 202 |             <primary sortas="d-sendsignals">sendsignals</primary>
 | 
|---|
| 203 |           </indexterm>
 | 
|---|
| 204 |         </listitem>
 | 
|---|
| 205 |       </varlistentry>
 | 
|---|
| 206 | 
 | 
|---|
| 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-scripts-bootscripts setclock-bootscripts">
 | 
|---|
| 213 |             <primary sortas="d-setclock">setclock</primary>
 | 
|---|
| 214 |           </indexterm>
 | 
|---|
| 215 |         </listitem>
 | 
|---|
| 216 |       </varlistentry>
 | 
|---|
| 217 | 
 | 
|---|
| 218 |       <varlistentry id="static-bootscripts">
 | 
|---|
| 219 |         <term><command>static</command></term>
 | 
|---|
| 220 |         <listitem>
 | 
|---|
| 221 |           <para>Provides the functionality needed to assign a static Internet
 | 
|---|
| 222 |           Protocol (IP) address to a network interface</para>
 | 
|---|
| 223 |           <indexterm zone="ch-scripts-bootscripts static-bootscripts">
 | 
|---|
| 224 |             <primary sortas="d-static">static</primary>
 | 
|---|
| 225 |           </indexterm>
 | 
|---|
| 226 |         </listitem>
 | 
|---|
| 227 |       </varlistentry>
 | 
|---|
| 228 | 
 | 
|---|
| 229 |       <varlistentry id="swap-bootscripts">
 | 
|---|
| 230 |         <term><command>swap</command></term>
 | 
|---|
| 231 |         <listitem>
 | 
|---|
| 232 |           <para>Enables and disables swap files and partitions</para>
 | 
|---|
| 233 |           <indexterm zone="ch-scripts-bootscripts swap-bootscripts">
 | 
|---|
| 234 |             <primary sortas="d-swap">swap</primary>
 | 
|---|
| 235 |           </indexterm>
 | 
|---|
| 236 |         </listitem>
 | 
|---|
| 237 |       </varlistentry>
 | 
|---|
| 238 | 
 | 
|---|
| 239 |       <varlistentry id="sysklogd-bootscripts">
 | 
|---|
| 240 |         <term><command>sysklogd</command></term>
 | 
|---|
| 241 |         <listitem>
 | 
|---|
| 242 |           <para>Starts and stops the system and kernel log daemons</para>
 | 
|---|
| 243 |           <indexterm zone="ch-scripts-bootscripts sysklogd-bootscripts">
 | 
|---|
| 244 |             <primary sortas="d-sysklogd">sysklogd</primary>
 | 
|---|
| 245 |           </indexterm>
 | 
|---|
| 246 |         </listitem>
 | 
|---|
| 247 |       </varlistentry>
 | 
|---|
| 248 | 
 | 
|---|
| 249 |       <varlistentry id="template-bootscripts">
 | 
|---|
| 250 |         <term><command>template</command></term>
 | 
|---|
| 251 |         <listitem>
 | 
|---|
| 252 |           <para>A template to create custom bootscripts for other
 | 
|---|
| 253 |           daemons</para>
 | 
|---|
| 254 |           <indexterm zone="ch-scripts-bootscripts template-bootscripts">
 | 
|---|
| 255 |             <primary sortas="d-template">template</primary>
 | 
|---|
| 256 |           </indexterm>
 | 
|---|
| 257 |         </listitem>
 | 
|---|
| 258 |       </varlistentry>
 | 
|---|
| 259 | 
 | 
|---|
| 260 |     </variablelist>
 | 
|---|
| 261 | 
 | 
|---|
| 262 |   </sect2>
 | 
|---|
| 263 | 
 | 
|---|
| 264 | </sect1>
 | 
|---|