source: BOOK/boot/common/sysvinit.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.8 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-sysvinit" role="wrap">
9  <?dbhtml filename="sysvinit.html"?>
10
11  <title>Sysvinit-&sysvinit-version;</title>
12
13  <indexterm zone="ch-boot-sysvinit">
14    <primary sortas="a-Sysvinit">Sysvinit</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Sysvinit package contains programs for controlling the startup,
21    running, and shutdown of the system.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Sysvinit</title>
27
28    <para os="p1">Apply a patch to prevent installation of unneeded programs,
29    and allow Sysvinit to be installed in
30    <filename class="directory">/tools</filename>:</para>
31
32<screen os="p2"><userinput>patch -Np1 -i ../sysvinit-&sysvinit-version;-tools_updates-1.patch</userinput></screen>
33
34    <para os ="c">Compile the package:</para>
35
36<screen os="ac"><userinput>make -C src clobber
37make -C src CC="${CC}"</userinput></screen>
38
39   <para os="e">Install the package:</para>
40
41<screen os="ad"><userinput>make -C src ROOT=/tools install</userinput></screen>
42
43  </sect2>
44
45  <sect2 id="conf-tools-sysvinit" role="configuration">
46    <title>Configuring Sysvinit</title>
47
48    <indexterm zone="conf-tools-sysvinit">
49      <primary sortas="a-Sysvinit">Sysvinit</primary>
50      <secondary>configuring</secondary>
51    </indexterm>
52
53    <indexterm zone="conf-tools-sysvinit">
54      <primary sortas="e-/etc/inittab">/etc/inittab</primary>
55    </indexterm>
56
57    <para>Create a new file <filename>/tools/etc/inittab</filename> by running the
58    following:</para>
59
60<screen><userinput>cat &gt; /tools/etc/inittab &lt;&lt; "EOF"
61<literal># Begin /tools/etc/inittab
62
63id:3:initdefault:
64
65si::sysinit:/tools/etc/rc.d/init.d/rc sysinit
66
67l0:0:wait:/tools/etc/rc.d/init.d/rc 0
68l1:S1:wait:/tools/etc/rc.d/init.d/rc 1
69l2:2:wait:/tools/etc/rc.d/init.d/rc 2
70l3:3:wait:/tools/etc/rc.d/init.d/rc 3
71l4:4:wait:/tools/etc/rc.d/init.d/rc 4
72l5:5:wait:/tools/etc/rc.d/init.d/rc 5
73l6:6:wait:/tools/etc/rc.d/init.d/rc 6
74
75ca:12345:ctrlaltdel:/tools/sbin/shutdown -t1 -a -r now
76
77su:S016:once:/tools/sbin/sulogin
78</literal>
79EOF</userinput></screen>
80
81    <para>The following command adds the standard virtual terminals to
82    <filename>/tools/etc/inittab</filename>. If your system only has a serial
83    console skip the following command:</para>
84
85<screen><userinput>cat &gt;&gt; /tools/etc/inittab &lt;&lt; "EOF"
86<literal>1:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty1 9600
872:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty2 9600
883:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty3 9600
894:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty4 9600
905:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty5 9600
916:2345:respawn:/tools/sbin/agetty --noclear -I '\033(K' tty6 9600
92</literal>
93EOF</userinput></screen>
94
95    <para>If your system has a serial console, run the following command to add
96    the entry to <filename>/tools/etc/inittab</filename>.</para>
97
98<screen><userinput>cat &gt;&gt; /tools/etc/inittab &lt;&lt; "EOF"
99<literal>c0:12345:respawn:/tools/sbin/agetty --noclear 115200 ttyS0 vt100
100</literal>
101EOF</userinput></screen>
102
103   <para>Finally, add the end line to <filename>/tools/etc/inittab</filename>.</para>
104
105<screen><userinput>cat &gt;&gt; /tools/etc/inittab &lt;&lt; "EOF"
106<literal># End /tools/etc/inittab</literal>
107EOF</userinput></screen>
108
109    <para>The <parameter>-I '\033(K'</parameter> option tells
110    <command>agetty</command> to send this escape sequence to the terminal
111    before doing anything else. This escape sequence switches the console
112    character set to a user-defined one, which can be modified by running
113    the <command>setfont</command> program. Sending this
114    escape sequence is necessary for people who use non-ISO 8859-1 screen
115    fonts, but it does not affect native English speakers.</para>
116
117  </sect2>
118
119  <sect2 id="contents-sysvinit" role="content">
120    <title>Contents of Sysvinit</title>
121
122    <segmentedlist>
123      <segtitle>Installed programs</segtitle>
124
125      <seglistitem>
126        <seg>bootlogd, fstab-decode, halt, init, killall5,
127        poweroff (link to halt), reboot (link to halt), runlevel,
128        shutdown, and telinit (link to init)</seg>
129      </seglistitem>
130    </segmentedlist>
131
132    <variablelist>
133      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
134      <?dbfo list-presentation="list"?>
135      <?dbhtml list-presentation="table"?>
136
137      <varlistentry id="bootlogd">
138        <term><command>bootlogd</command></term>
139        <listitem>
140          <para>Logs boot messages to a log file</para>
141          <indexterm zone="ch-boot-sysvinit bootlogd">
142            <primary sortas="b-bootlogd">bootlogd</primary>
143          </indexterm>
144        </listitem>
145      </varlistentry>
146
147      <varlistentry id="fstab-decode">
148        <term><command>fstab-decode</command></term>
149        <listitem>
150          <para>Runs a command with fstab-encoded arguments</para>
151          <indexterm zone="ch-boot-sysvinit fstab-decode">
152            <primary sortas="b-fstab-decode">fstab-decode</primary>
153          </indexterm>
154        </listitem>
155      </varlistentry>
156
157      <varlistentry id="halt-sysv">
158        <term><command>halt</command></term>
159        <listitem>
160          <para>Normally invokes <command>shutdown</command> with the
161          <parameter>-h</parameter> option, except when already in run-level 0,
162          then it tells the kernel to halt the system; it notes in the
163          file <filename>/var/log/wtmp</filename> that the system is being
164          brought down</para>
165          <indexterm zone="ch-boot-sysvinit halt-sysv">
166            <primary sortas="b-halt-sysv">halt</primary>
167          </indexterm>
168        </listitem>
169      </varlistentry>
170
171      <varlistentry id="init-sysv">
172        <term><command>init</command></term>
173        <listitem>
174          <para>The first process to be started when the kernel has initialized
175          the hardware which takes over the boot process and starts all the
176          proceses it is instructed to</para>
177          <indexterm zone="ch-boot-sysvinit init-sysv">
178            <primary sortas="b-init-sysv">init</primary>
179          </indexterm>
180        </listitem>
181      </varlistentry>
182
183      <varlistentry id="killall5">
184        <term><command>killall5</command></term>
185        <listitem>
186          <para>Sends a signal to all processes, except the processes in its own
187          session so it will not kill the shell running the script that called
188          it</para>
189          <indexterm zone="ch-boot-sysvinit killall5">
190            <primary sortas="b-killall5">killall5</primary>
191          </indexterm>
192        </listitem>
193      </varlistentry>
194
195      <varlistentry id="poweroff-sysv">
196        <term><command>poweroff</command></term>
197        <listitem>
198          <para>Tells the kernel to halt the system and switch off the computer
199          (see <command>halt</command>)</para>
200          <indexterm zone="ch-boot-sysvinit poweroff-sysv">
201            <primary sortas="b-poweroff-sysv">poweroff</primary>
202          </indexterm>
203        </listitem>
204      </varlistentry>
205
206      <varlistentry id="reboot-sysv">
207        <term><command>reboot</command></term>
208        <listitem>
209          <para>Tells the kernel to reboot the system (see
210          <command>halt</command>)</para>
211          <indexterm zone="ch-boot-sysvinit reboot-sysv">
212            <primary sortas="b-reboot-sysv">reboot</primary>
213          </indexterm>
214        </listitem>
215      </varlistentry>
216
217      <varlistentry id="runlevel-sysv">
218        <term><command>runlevel</command></term>
219        <listitem>
220          <para>Reports the previous and the current run-level, as noted in
221          the last run-level record in <filename>/run/utmp</filename></para>
222          <indexterm zone="ch-boot-sysvinit runlevel-sysv">
223            <primary sortas="b-runlevel-sysv">runlevel</primary>
224          </indexterm>
225        </listitem>
226      </varlistentry>
227
228      <varlistentry id="shutdown-sysv">
229        <term><command>shutdown</command></term>
230        <listitem>
231          <para>Brings the system down in a secure way, signaling all processes
232          and notifying all logged-in users</para>
233          <indexterm zone="ch-boot-sysvinit shutdown-sysv">
234            <primary sortas="b-shutdown-sysv">shutdown</primary>
235          </indexterm>
236        </listitem>
237      </varlistentry>
238
239      <varlistentry id="telinit-sysv">
240        <term><command>telinit</command></term>
241        <listitem>
242          <para>Tells <command>init</command> which run-level to change to</para>
243          <indexterm zone="ch-boot-sysvinit telinit-sysv">
244            <primary sortas="b-telinit-sysv">telinit</primary>
245          </indexterm>
246        </listitem>
247      </varlistentry>
248
249    </variablelist>
250
251  </sect2>
252
253</sect1>
Note: See TracBrowser for help on using the repository browser.