[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 4 | %general-entities;
|
---|
| 5 | ]>
|
---|
[a001133] | 6 | <sect1 id="ch-scripts-bootscripts" xreflabel="Bootscripts" role="wrap">
|
---|
[673b0d8] | 7 | <title>LFS-Bootscripts-&bootscripts-version;</title>
|
---|
| 8 | <?dbhtml filename="bootscripts.html"?>
|
---|
| 9 |
|
---|
| 10 | <indexterm zone="ch-scripts-bootscripts"><primary sortas="a-Bootscripts">Bootscripts</primary></indexterm>
|
---|
[418e6cc] | 11 |
|
---|
[a001133] | 12 | <sect2 role="package"><title/>
|
---|
[418e6cc] | 13 | <para>The LFS-Bootscripts package contains a set of bootscripts.</para>
|
---|
| 14 |
|
---|
[a001133] | 15 | <segmentedlist>
|
---|
| 16 | <segtitle>&buildtime;</segtitle>
|
---|
| 17 | <segtitle>&diskspace;</segtitle>
|
---|
| 18 | <seglistitem><seg>0.1 SBU</seg><seg>0.3 MB</seg></seglistitem>
|
---|
| 19 | </segmentedlist>
|
---|
[418e6cc] | 20 |
|
---|
[a001133] | 21 | <segmentedlist>
|
---|
| 22 | <segtitle>LFS-Bootscripts installation depends on</segtitle>
|
---|
| 23 | <seglistitem><seg>Bash, Coreutils</seg></seglistitem>
|
---|
| 24 | </segmentedlist>
|
---|
| 25 | </sect2>
|
---|
[418e6cc] | 26 |
|
---|
[a001133] | 27 | <sect2 role="installation">
|
---|
[418e6cc] | 28 | <title>Installation of LFS-Bootscripts</title>
|
---|
| 29 |
|
---|
[673b0d8] | 30 | <para>Installation of the bootscripts is very simple:</para>
|
---|
| 31 |
|
---|
| 32 | <screen><userinput>make install</userinput></screen>
|
---|
| 33 |
|
---|
[9ae5ef3] | 34 | <para>Since this version of LFS also uses the hotplug package, we also want to
|
---|
| 35 | make sure we install the bootscripts for that as well:</para>
|
---|
| 36 |
|
---|
| 37 | <screen><userinput>make install-hotplug</userinput></screen>
|
---|
| 38 |
|
---|
[673b0d8] | 39 | </sect2>
|
---|
[418e6cc] | 40 |
|
---|
| 41 |
|
---|
[c6cb3aa] | 42 | <sect2 id="contents-bootscripts" role="content"><title>Contents of LFS-bootscripts</title>
|
---|
[418e6cc] | 43 |
|
---|
[c6cb3aa] | 44 | <segmentedlist>
|
---|
| 45 | <segtitle>Installed scripts</segtitle>
|
---|
| 46 | <seglistitem><seg>checkfs, cleanfs, console, functions, halt, ifdown, ifup,
|
---|
| 47 | localnet, mountfs, mountkernfs, network, rc, reboot, sendsignals, setclock, static,
|
---|
| 48 | swap, sysklogd and template</seg></seglistitem>
|
---|
| 49 | </segmentedlist>
|
---|
[418e6cc] | 50 |
|
---|
[c6cb3aa] | 51 | <variablelist><title>Short descriptions</title>
|
---|
[673b0d8] | 52 |
|
---|
[b8a819f] | 53 | <varlistentry id="checkfs-bootscripts">
|
---|
| 54 | <term><command>checkfs</command></term>
|
---|
[c6cb3aa] | 55 | <listitem>
|
---|
[673b0d8] | 56 | <indexterm zone="ch-scripts-bootscripts checkfs-bootscripts"><primary sortas="d-checkfs">checkfs</primary></indexterm>
|
---|
[c6cb3aa] | 57 | <para>checks the file systems just before they are mounted (with the exception of journal
|
---|
| 58 | and network based file systems).</para>
|
---|
| 59 | </listitem>
|
---|
| 60 | </varlistentry>
|
---|
| 61 |
|
---|
[b8a819f] | 62 | <varlistentry id="cleanfs-bootscripts">
|
---|
| 63 | <term><command>cleanfs</command></term>
|
---|
[c6cb3aa] | 64 | <listitem>
|
---|
[673b0d8] | 65 | <indexterm zone="ch-scripts-bootscripts cleanfs-bootscripts"><primary sortas="d-cleanfs">cleanfs</primary></indexterm>
|
---|
[c6cb3aa] | 66 | <para>removes files that shouldn't be
|
---|
[f67f5cf] | 67 | preserved between reboots, such as those in <filename class="directory">/var/run/</filename> and
|
---|
| 68 | <filename class="directory">/var/lock/</filename>. It re-creates <filename>/var/run/utmp</filename>
|
---|
[673b0d8] | 69 | and removes the possibly present <filename>/etc/nologin</filename>,
|
---|
| 70 | <filename>/fastboot</filename> and <filename>/forcefsck</filename> files.</para>
|
---|
[c6cb3aa] | 71 | </listitem>
|
---|
| 72 | </varlistentry>
|
---|
[673b0d8] | 73 |
|
---|
[b8a819f] | 74 | <varlistentry id="console-bootscripts">
|
---|
| 75 | <term><command>console</command></term>
|
---|
[c6cb3aa] | 76 | <listitem>
|
---|
[b32e803] | 77 | <indexterm zone="ch-scripts-bootscripts console-bootscripts"><primary sortas="d-console">console</primary></indexterm>
|
---|
[c6cb3aa] | 78 | <para>loads the keymap table you specified as proper for your keyboard layout.
|
---|
[b32e803] | 79 | It also sets the screen font.</para>
|
---|
[c6cb3aa] | 80 | </listitem>
|
---|
| 81 | </varlistentry>
|
---|
[b32e803] | 82 |
|
---|
[b8a819f] | 83 | <varlistentry id="functions-bootscripts">
|
---|
| 84 | <term><command>functions</command></term>
|
---|
[c6cb3aa] | 85 | <listitem>
|
---|
[673b0d8] | 86 | <indexterm zone="ch-scripts-bootscripts functions-bootscripts"><primary sortas="d-functions">functions</primary></indexterm>
|
---|
[c6cb3aa] | 87 | <para>contains functions shared among
|
---|
[673b0d8] | 88 | different scripts, such as error and status checking.</para>
|
---|
[c6cb3aa] | 89 | </listitem>
|
---|
| 90 | </varlistentry>
|
---|
[673b0d8] | 91 |
|
---|
[b8a819f] | 92 | <varlistentry id="halt-bootscripts">
|
---|
| 93 | <term><command>halt</command></term>
|
---|
[c6cb3aa] | 94 | <listitem>
|
---|
[673b0d8] | 95 | <indexterm zone="ch-scripts-bootscripts halt-bootscripts"><primary sortas="d-halt">halt</primary></indexterm>
|
---|
[c6cb3aa] | 96 | <para>halts the system.</para>
|
---|
| 97 | </listitem>
|
---|
| 98 | </varlistentry>
|
---|
[673b0d8] | 99 |
|
---|
[b8a819f] | 100 | <varlistentry id="ifdown-bootscripts">
|
---|
| 101 | <term><command>ifdown</command> and <command>ifup</command></term>
|
---|
[c6cb3aa] | 102 | <listitem>
|
---|
[673b0d8] | 103 | <indexterm zone="ch-scripts-bootscripts ifdown-bootscripts"><primary sortas="d-ifdown">ifdown</primary></indexterm>
|
---|
[c6cb3aa] | 104 | <para>assist the network script with network devices.</para>
|
---|
| 105 | </listitem>
|
---|
| 106 | </varlistentry>
|
---|
[673b0d8] | 107 |
|
---|
[b8a819f] | 108 | <varlistentry id="localnet-bootscripts">
|
---|
| 109 | <term><command>localnet</command></term>
|
---|
[c6cb3aa] | 110 | <listitem>
|
---|
[673b0d8] | 111 | <indexterm zone="ch-scripts-bootscripts localnet-bootscripts"><primary sortas="d-localnet">localnet</primary></indexterm>
|
---|
[c6cb3aa] | 112 | <para>sets up the system's hostname and local loopback device.</para>
|
---|
| 113 | </listitem>
|
---|
| 114 | </varlistentry>
|
---|
[673b0d8] | 115 |
|
---|
[b8a819f] | 116 | <varlistentry id="mountfs-bootscripts">
|
---|
| 117 | <term><command>mountfs</command></term>
|
---|
[c6cb3aa] | 118 | <listitem>
|
---|
[673b0d8] | 119 | <indexterm zone="ch-scripts-bootscripts mountfs-bootscripts"><primary sortas="d-mountfs">mountfs</primary></indexterm>
|
---|
[c6cb3aa] | 120 | <para>mounts all file systems that
|
---|
[673b0d8] | 121 | aren't marked <emphasis>noauto</emphasis> or aren't network based.</para>
|
---|
[c6cb3aa] | 122 | </listitem>
|
---|
| 123 | </varlistentry>
|
---|
[673b0d8] | 124 |
|
---|
[b8a819f] | 125 | <varlistentry id="mountkernfs-bootscripts">
|
---|
| 126 | <term><command>mountkernfs</command></term>
|
---|
[c6cb3aa] | 127 | <listitem>
|
---|
[673b0d8] | 128 | <indexterm zone="ch-scripts-bootscripts mountkernfs-bootscripts"><primary sortas="d-mountkernfs">mountkernfs</primary></indexterm>
|
---|
[f67f5cf] | 129 | <para>is used to mount kernel-provided file systems, such as <systemitem class="filesystem">proc</systemitem>.</para>
|
---|
[c6cb3aa] | 130 | </listitem>
|
---|
| 131 | </varlistentry>
|
---|
[418e6cc] | 132 |
|
---|
[b8a819f] | 133 | <varlistentry id="network-bootscripts">
|
---|
| 134 | <term><command>network</command></term>
|
---|
[c6cb3aa] | 135 | <listitem>
|
---|
[673b0d8] | 136 | <indexterm zone="ch-scripts-bootscripts network-bootscripts"><primary sortas="d-network">network</primary></indexterm>
|
---|
[c6cb3aa] | 137 | <para>sets up network interfaces, such
|
---|
[673b0d8] | 138 | as network cards, and sets up the default gateway where applicable.</para>
|
---|
[c6cb3aa] | 139 | </listitem>
|
---|
| 140 | </varlistentry>
|
---|
[673b0d8] | 141 |
|
---|
[b8a819f] | 142 | <varlistentry id="rc-bootscripts">
|
---|
| 143 | <term><command>rc</command></term>
|
---|
[c6cb3aa] | 144 | <listitem>
|
---|
[673b0d8] | 145 | <indexterm zone="ch-scripts-bootscripts rc-bootscripts"><primary sortas="d-rc">rc</primary></indexterm>
|
---|
[c6cb3aa] | 146 | <para>is the master run-level control script.
|
---|
[673b0d8] | 147 | It is responsible for running all the other scripts one-by-one, in a sequence
|
---|
| 148 | determined by the name of the symbolic links being processed.</para>
|
---|
[c6cb3aa] | 149 | </listitem>
|
---|
| 150 | </varlistentry>
|
---|
[673b0d8] | 151 |
|
---|
[b8a819f] | 152 | <varlistentry id="reboot-bootscripts">
|
---|
| 153 | <term><command>reboot</command></term>
|
---|
[c6cb3aa] | 154 | <listitem>
|
---|
[673b0d8] | 155 | <indexterm zone="ch-scripts-bootscripts reboot-bootscripts"><primary sortas="d-reboot">reboot</primary></indexterm>
|
---|
[c6cb3aa] | 156 | <para>reboots the system.</para>
|
---|
| 157 | </listitem>
|
---|
| 158 | </varlistentry>
|
---|
[673b0d8] | 159 |
|
---|
[b8a819f] | 160 | <varlistentry id="sendsignals-bootscripts">
|
---|
| 161 | <term><command>sendsignals</command></term>
|
---|
[c6cb3aa] | 162 | <listitem>
|
---|
[673b0d8] | 163 | <indexterm zone="ch-scripts-bootscripts sendsignals-bootscripts"><primary sortas="d-sendsignals">sendsignals</primary></indexterm>
|
---|
[c6cb3aa] | 164 | <para>makes sure every process is terminated before the system reboots or halts.</para>
|
---|
| 165 | </listitem>
|
---|
| 166 | </varlistentry>
|
---|
[673b0d8] | 167 |
|
---|
[b8a819f] | 168 | <varlistentry id="setclock-bootscripts">
|
---|
| 169 | <term><command>setclock</command></term>
|
---|
[c6cb3aa] | 170 | <listitem>
|
---|
[673b0d8] | 171 | <indexterm zone="ch-scripts-bootscripts setclock-bootscripts"><primary sortas="d-setclock">setclock</primary></indexterm>
|
---|
[c6cb3aa] | 172 | <para>resets the kernel clock to
|
---|
[673b0d8] | 173 | localtime in case the hardware clock isn't set to GMT time.</para>
|
---|
[c6cb3aa] | 174 | </listitem>
|
---|
| 175 | </varlistentry>
|
---|
[673b0d8] | 176 |
|
---|
[b8a819f] | 177 | <varlistentry id="static-bootscripts">
|
---|
| 178 | <term><command>static</command></term>
|
---|
[c6cb3aa] | 179 | <listitem>
|
---|
[673b0d8] | 180 | <indexterm zone="ch-scripts-bootscripts static-bootscripts"><primary sortas="d-static">static</primary></indexterm>
|
---|
[c6cb3aa] | 181 | <para>provides the functionality needed
|
---|
[673b0d8] | 182 | to assign a static IP address to a network interface.</para>
|
---|
[c6cb3aa] | 183 | </listitem>
|
---|
| 184 | </varlistentry>
|
---|
[673b0d8] | 185 |
|
---|
[b8a819f] | 186 | <varlistentry id="swap-bootscripts">
|
---|
| 187 | <term><command>swap</command></term>
|
---|
[c6cb3aa] | 188 | <listitem>
|
---|
[673b0d8] | 189 | <indexterm zone="ch-scripts-bootscripts swap-bootscripts"><primary sortas="d-swap">swap</primary></indexterm>
|
---|
[c6cb3aa] | 190 | <para>enables and disables swap files and partitions.</para>
|
---|
| 191 | </listitem>
|
---|
| 192 | </varlistentry>
|
---|
[673b0d8] | 193 |
|
---|
[b8a819f] | 194 | <varlistentry id="sysklogd-bootscripts">
|
---|
| 195 | <term><command>sysklogd</command></term>
|
---|
[c6cb3aa] | 196 | <listitem>
|
---|
[673b0d8] | 197 | <indexterm zone="ch-scripts-bootscripts sysklogd-bootscripts"><primary sortas="d-sysklogd">sysklogd</primary></indexterm>
|
---|
[c6cb3aa] | 198 | <para>starts and stops the system and kernel log daemons.</para>
|
---|
| 199 | </listitem>
|
---|
| 200 | </varlistentry>
|
---|
[673b0d8] | 201 |
|
---|
[b8a819f] | 202 | <varlistentry id="template-bootscripts">
|
---|
| 203 | <term><command>template</command></term>
|
---|
[c6cb3aa] | 204 | <listitem>
|
---|
[673b0d8] | 205 | <indexterm zone="ch-scripts-bootscripts template-bootscripts"><primary sortas="d-template">template</primary></indexterm>
|
---|
[c6cb3aa] | 206 | <para>is a template you can use to
|
---|
[673b0d8] | 207 | create your own bootscripts for your other daemons.</para>
|
---|
[c6cb3aa] | 208 | </listitem>
|
---|
| 209 | </varlistentry>
|
---|
| 210 | </variablelist>
|
---|
[673b0d8] | 211 |
|
---|
| 212 | </sect2>
|
---|
| 213 |
|
---|
| 214 | </sect1>
|
---|