source: BOOK/boot/common/boot-scripts.xml @ 59913e1

clfs-3.0.0-systemdsystemd
Last change on this file since 59913e1 was 59913e1, checked in by Chris Staub <chris@…>, 8 years ago

Changed /var/run references to /run

  • Property mode set to 100644
File size: 8.4 KB
Line 
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
8<sect1 id="ch-boot-boot-scripts" role="wrap">
9  <?dbhtml filename="boot-scripts.html"?>
10
11  <title>Boot-scripts for CLFS &boot-scripts-clfs-version;</title>
12
13  <indexterm zone="ch-boot-boot-scripts">
14    <primary sortas="a-Boot-scripts">Boot-scripts</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Boot-scripts 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 Boot-scripts</title>
27
28    <para os="a">Install the package:</para>
29
30<screen os="b"><userinput>make DESTDIR=/tools install-boot-scripts</userinput></screen>
31
32  <para os="c">The <command>setclock</command> script reads the time from the
33  hardware clock, also known as the BIOS or the Complementary Metal Oxide
34  Semiconductor (CMOS) clock. If the hardware clock is set to UTC, this
35  script will convert the hardware clock's time to the local time using
36  the <filename>/tools/etc/sysconfig/clock</filename> file (which tells the
37  <command>hwclock</command> program which timezone the user is in). There
38  is no way to detect whether or not the hardware clock is set to UTC, so
39  this needs to be configured manually.</para>
40
41
42
43  <para os="d">If you do not know whether or not the hardware clock is set to UTC,
44  you can find out after you have booted the new machine by running the
45  <userinput>hwclock --localtime  --show</userinput> command, and if
46  necessary editing the <filename>/tools/etc/sysconfig/clock</filename> file.
47  The worst that will happen if you make a wrong guess here is that the
48  time displayed will be wrong.</para>
49
50  <para os="e">Change the value of the <envar>UTC</envar> variable below
51  to a value of <option>0</option> (zero) if the hardware clock
52  is <emphasis>not</emphasis> set to UTC time.</para>
53
54<screen os="f"><userinput>cat &gt; /tools/etc/sysconfig/clock &lt;&lt; "EOF"
55<literal># Begin /tools/etc/sysconfig/clock
56
57UTC=1
58
59# End /tools/etc/sysconfig/clock</literal>
60EOF</userinput></screen>
61
62  </sect2>
63
64  <sect2 id="contents-boot-scripts" role="content">
65    <title>Contents of Boot-scripts</title>
66
67    <segmentedlist>
68      <segtitle>Installed scripts</segtitle>
69
70      <seglistitem>
71        <seg>checkfs, cleanfs, functions, halt, localnet, mountfs, mountkernfs,
72        rc, reboot, sendsignals, setclock, swap, and udev.</seg>
73      </seglistitem>
74    </segmentedlist>
75
76    <variablelist>
77      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
78      <?dbfo list-presentation="list"?>
79      <?dbhtml list-presentation="table"?>
80
81      <varlistentry id="checkfs-boot-scripts">
82        <term><command>checkfs</command></term>
83        <listitem>
84          <para>Checks the integrity of the file systems before they are
85          mounted (with the exception of journal and network based file
86          systems)</para>
87          <indexterm zone="ch-boot-boot-scripts checkfs-boot-scripts">
88            <primary sortas="d-checkfs">checkfs</primary>
89          </indexterm>
90        </listitem>
91      </varlistentry>
92
93      <varlistentry id="cleanfs-boot-scripts">
94        <term><command>cleanfs</command></term>
95        <listitem>
96          <para>Removes files that should not be preserved between reboots,
97          such as those in <filename class="directory">/run/</filename>
98          and <filename class="directory">/var/lock/</filename>; it re-creates
99          <filename>/run/utmp</filename> and removes the possibly present
100          <filename>/etc/nologin</filename>, <filename>/fastboot</filename>,
101          and <filename>/forcefsck</filename> files</para>
102          <indexterm zone="ch-boot-boot-scripts cleanfs-boot-scripts">
103            <primary sortas="d-cleanfs">cleanfs</primary>
104          </indexterm>
105        </listitem>
106      </varlistentry>
107
108      <varlistentry id="functions-boot-scripts">
109        <term><command>functions</command></term>
110        <listitem>
111          <para>Contains common functions, such as error and status checking,
112          that are used by several boot-scripts</para>
113          <indexterm zone="ch-boot-boot-scripts functions-boot-scripts">
114            <primary sortas="d-functions">functions</primary>
115          </indexterm>
116        </listitem>
117      </varlistentry>
118
119      <varlistentry id="halt-boot-scripts">
120        <term><command>halt</command></term>
121        <listitem>
122          <para>Halts the system</para>
123          <indexterm zone="ch-boot-boot-scripts halt-boot-scripts">
124            <primary sortas="d-halt">halt</primary>
125          </indexterm>
126        </listitem>
127      </varlistentry>
128
129      <varlistentry id="localnet-boot-scripts">
130        <term><command>localnet</command></term>
131        <listitem>
132          <para>Sets up the system's hostname and local loopback device</para>
133          <indexterm zone="ch-boot-boot-scripts localnet-boot-scripts">
134            <primary sortas="d-localnet">localnet</primary>
135          </indexterm>
136        </listitem>
137      </varlistentry>
138
139      <varlistentry id="mountfs-boot-scripts">
140        <term><command>mountfs</command></term>
141        <listitem>
142          <para>Mounts all file systems, except ones that are marked
143          <emphasis>noauto</emphasis> or are network based</para>
144          <indexterm zone="ch-boot-boot-scripts mountfs-boot-scripts">
145            <primary sortas="d-mountfs">mountfs</primary>
146          </indexterm>
147        </listitem>
148      </varlistentry>
149
150      <varlistentry id="mountkernfs-boot-scripts">
151        <term><command>mountkernfs</command></term>
152        <listitem>
153          <para>Mounts virtual kernel file systems, such as
154          <systemitem class="filesystem">proc</systemitem></para>
155          <indexterm zone="ch-boot-boot-scripts mountkernfs-boot-scripts">
156            <primary sortas="d-mountkernfs">mountkernfs</primary>
157          </indexterm>
158        </listitem>
159      </varlistentry>
160
161      <varlistentry id="rc-boot-scripts">
162        <term><command>rc</command></term>
163        <listitem>
164          <para>The master run-level control script; it is responsible for
165          running all the other boot-scripts one-by-one, in a sequence
166          determined by the name of the symbolic links being processed</para>
167          <indexterm zone="ch-boot-boot-scripts rc-boot-scripts">
168            <primary sortas="d-rc">rc</primary>
169          </indexterm>
170        </listitem>
171      </varlistentry>
172
173      <varlistentry id="reboot-boot-scripts">
174        <term><command>reboot</command></term>
175        <listitem>
176          <para>Reboots the system</para>
177          <indexterm zone="ch-boot-boot-scripts reboot-boot-scripts">
178            <primary sortas="d-reboot">reboot</primary>
179          </indexterm>
180        </listitem>
181      </varlistentry>
182
183      <varlistentry id="sendsignals-boot-scripts">
184        <term><command>sendsignals</command></term>
185        <listitem>
186          <para>Makes sure every process is terminated before the system reboots
187          or halts</para>
188          <indexterm zone="ch-boot-boot-scripts sendsignals-boot-scripts">
189            <primary sortas="d-sendsignals">sendsignals</primary>
190          </indexterm>
191        </listitem>
192      </varlistentry>
193
194      <varlistentry id="setclock-boot-scripts">
195        <term><command>setclock</command></term>
196        <listitem>
197          <para>Resets the kernel clock to local time in case the hardware clock
198          is not set to UTC time</para>
199          <indexterm zone="ch-boot-boot-scripts setclock-boot-scripts">
200            <primary sortas="d-setclock">setclock</primary>
201          </indexterm>
202        </listitem>
203      </varlistentry>
204
205      <varlistentry id="swap-boot-scripts">
206        <term><command>swap</command></term>
207        <listitem>
208          <para>Enables and disables swap files and partitions</para>
209          <indexterm zone="ch-boot-boot-scripts swap-boot-scripts">
210            <primary sortas="d-swap">swap</primary>
211          </indexterm>
212        </listitem>
213      </varlistentry>
214
215      <varlistentry id="eudev-boot-scripts">
216        <term><command>udev</command></term>
217        <listitem>
218          <para>Starts and stops the Eudev daemon</para>
219          <indexterm zone="ch-boot-boot-scripts eudev-boot-scripts">
220            <primary sortas="d-eudev">udev</primary>
221          </indexterm>
222        </listitem>
223      </varlistentry>
224
225    </variablelist>
226
227  </sect2>
228
229</sect1>
Note: See TracBrowser for help on using the repository browser.