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