source: BOOK/boot/common/sysvinit.xml@ 5c8e74d

Last change on this file since 5c8e74d was d2ecc65, checked in by Chris Staub <chris@…>, 11 years ago

Reorganized boot section

  • Property mode set to 100644
File size: 8.9 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>boot, 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. The <command>console</command>
114 initscript from the CLFS-Bootscripts package calls the
115 <command>setfont</command> program during system startup. Sending this
116 escape sequence is necessary for people who use non-ISO 8859-1 screen
117 fonts, but it does not affect native English speakers.</para>
118
119 </sect2>
120
121 <sect2 id="contents-sysvinit" role="content">
122 <title>Contents of Sysvinit</title>
123
124 <segmentedlist>
125 <segtitle>Installed programs</segtitle>
126
127 <seglistitem>
128 <seg>bootlogd, fstab-decode, halt, init, killall5,
129 poweroff (link to halt), reboot (link to halt), runlevel,
130 shutdown, and telinit (link to init)</seg>
131 </seglistitem>
132 </segmentedlist>
133
134 <variablelist>
135 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
136 <?dbfo list-presentation="list"?>
137 <?dbhtml list-presentation="table"?>
138
139 <varlistentry id="bootlogd">
140 <term><command>bootlogd</command></term>
141 <listitem>
142 <para>Logs boot messages to a log file</para>
143 <indexterm zone="ch-boot-sysvinit bootlogd">
144 <primary sortas="b-bootlogd">bootlogd</primary>
145 </indexterm>
146 </listitem>
147 </varlistentry>
148
149 <varlistentry id="fstab-decode">
150 <term><command>fstab-decode</command></term>
151 <listitem>
152 <para>Runs a command with fstab-encoded arguments</para>
153 <indexterm zone="ch-boot-sysvinit fstab-decode">
154 <primary sortas="b-fstab-decode">fstab-decode</primary>
155 </indexterm>
156 </listitem>
157 </varlistentry>
158
159 <varlistentry id="halt">
160 <term><command>halt</command></term>
161 <listitem>
162 <para>Normally invokes <command>shutdown</command> with the
163 <parameter>-h</parameter> option, except when already in run-level 0,
164 then it tells the kernel to halt the system; it notes in the
165 file <filename>/var/log/wtmp</filename> that the system is being
166 brought down</para>
167 <indexterm zone="ch-boot-sysvinit halt">
168 <primary sortas="b-halt">halt</primary>
169 </indexterm>
170 </listitem>
171 </varlistentry>
172
173 <varlistentry id="init">
174 <term><command>init</command></term>
175 <listitem>
176 <para>The first process to be started when the kernel has initialized
177 the hardware which takes over the boot process and starts all the
178 proceses it is instructed to</para>
179 <indexterm zone="ch-boot-sysvinit init">
180 <primary sortas="b-init">init</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 <varlistentry id="killall5">
186 <term><command>killall5</command></term>
187 <listitem>
188 <para>Sends a signal to all processes, except the processes in its own
189 session so it will not kill the shell running the script that called
190 it</para>
191 <indexterm zone="ch-boot-sysvinit killall5">
192 <primary sortas="b-killall5">killall5</primary>
193 </indexterm>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry id="poweroff">
198 <term><command>poweroff</command></term>
199 <listitem>
200 <para>Tells the kernel to halt the system and switch off the computer
201 (see <command>halt</command>)</para>
202 <indexterm zone="ch-boot-sysvinit poweroff">
203 <primary sortas="b-poweroff">poweroff</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 <varlistentry id="reboot">
209 <term><command>reboot</command></term>
210 <listitem>
211 <para>Tells the kernel to reboot the system (see
212 <command>halt</command>)</para>
213 <indexterm zone="ch-boot-sysvinit reboot">
214 <primary sortas="b-reboot">reboot</primary>
215 </indexterm>
216 </listitem>
217 </varlistentry>
218
219 <varlistentry id="runlevel">
220 <term><command>runlevel</command></term>
221 <listitem>
222 <para>Reports the previous and the current run-level, as noted in
223 the last run-level record in <filename>/var/run/utmp</filename></para>
224 <indexterm zone="ch-boot-sysvinit runlevel">
225 <primary sortas="b-runlevel">runlevel</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="shutdown">
231 <term><command>shutdown</command></term>
232 <listitem>
233 <para>Brings the system down in a secure way, signaling all processes
234 and notifying all logged-in users</para>
235 <indexterm zone="ch-boot-sysvinit shutdown">
236 <primary sortas="b-shutdown">shutdown</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="telinit">
242 <term><command>telinit</command></term>
243 <listitem>
244 <para>Tells <command>init</command> which run-level to change to</para>
245 <indexterm zone="ch-boot-sysvinit telinit">
246 <primary sortas="b-telinit">telinit</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.