lfs/chapter08/sysvinit.xml
2024-01-18 20:53:23 +01:00

221 lines
7.8 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="ch-system-sysvinit" role="wrap" revision="sysv">
<?dbhtml filename="sysvinit.html"?>
<sect1info condition="script">
<productname>sysvinit</productname>
<productnumber>&sysvinit-version;</productnumber>
<address>&sysvinit-url;</address>
</sect1info>
<title>Sysvinit-&sysvinit-version;</title>
<indexterm zone="ch-system-sysvinit">
<primary sortas="a-Sysvinit">Sysvinit</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Sysvinit package contains programs for controlling the startup,
running, and shutdown of the system.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>&sysvinit-fin-sbu;</seg>
<seg>&sysvinit-fin-du;</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Sysvinit</title>
<!--
<para>When run-levels are changed (for example, when halting the
system), <command>init</command> sends termination signals to those
processes that <command>init</command> itself started and that should
not be running in the new run-level. While doing this,
<command>init</command> outputs messages like <quote>Sending processes
the TERM signal</quote> which seem to imply that it is sending these
signals to all currently running processes. To avoid this
misinterpretation, modify the source so that these messages read like
<quote>Sending processes configured via /etc/inittab the TERM signal</quote>
instead:</para>
<screen><userinput remap="pre">sed -i 's@Sending processes@&amp; configured via /etc/inittab@g' src/init.c</userinput></screen>
<para>Maintained versions of the <command>wall</command>,
<command>mountpoint</command>, <command>last</command>,
<command>mesg</command>, <command>sulogin</command>, and
<command>utmpdump</command> programs were installed earlier by Util-linux.
Suppress the installation of Sysvinit's versions of these programs and
their man pages:</para>
<screen><userinput remap="make">sed -ri -e '/utmpdump/d' \
-e '/mountpoint/d' \
-e '/mesg/d' \
-e 's/= sulogin(\.8)?/=/' src/Makefile</userinput></screen>
-->
<para>First, apply a patch that removes several programs installed by other
packages, clarifies a message, and fixes a compiler warning:</para>
<screen><userinput remap="pre">patch -Np1 -i ../&sysvinit-consolidated-patch;</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Install the package:</para>
<screen><userinput remap="install">make install</userinput></screen>
</sect2>
<sect2 id="contents-sysvinit" role="content">
<title>Contents of Sysvinit</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem>
<seg>bootlogd, fstab-decode, halt, init, killall5,
poweroff (link to halt), reboot (link to halt), runlevel,
shutdown, and telinit (link to init)</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bootlogd">
<term><command>bootlogd</command></term>
<listitem>
<para>Logs boot messages to a log file</para>
<indexterm zone="ch-system-sysvinit bootlogd">
<primary sortas="b-bootlogd">bootlogd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="fstab-decode">
<term><command>fstab-decode</command></term>
<listitem>
<para>Runs a command with fstab-encoded arguments</para>
<indexterm zone="ch-system-sysvinit fstab-decode">
<primary sortas="b-fstab-decode">fstab-decode</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="halt-sysv">
<term><command>halt</command></term>
<listitem>
<para>Normally invokes <command>shutdown</command> with the
<parameter>-h</parameter> option, but when already in run-level 0,
it tells the kernel to halt the system; it notes in the
file <filename>/var/log/wtmp</filename> that the system is
going down</para>
<indexterm zone="ch-system-sysvinit halt-sysv">
<primary sortas="b-halt">halt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="init-sysv">
<term><command>init</command></term>
<listitem>
<para>The first process to be started when the kernel has initialized
the hardware; it takes over the boot process and starts all the
processes specified in its configuration file</para>
<indexterm zone="ch-system-sysvinit init-sysv">
<primary sortas="b-init">init</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="killall5">
<term><command>killall5</command></term>
<listitem>
<para>Sends a signal to all processes, except the processes in its own
session; it will not kill its parent shell</para>
<indexterm zone="ch-system-sysvinit killall5">
<primary sortas="b-killall5">killall5</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="poweroff-sysv">
<term><command>poweroff</command></term>
<listitem>
<para>Tells the kernel to halt the system and switch off the computer
(see <command>halt</command>)</para>
<indexterm zone="ch-system-sysvinit poweroff-sysv">
<primary sortas="b-poweroff">poweroff</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="reboot-sysv">
<term><command>reboot</command></term>
<listitem>
<para>Tells the kernel to reboot the system (see
<command>halt</command>)</para>
<indexterm zone="ch-system-sysvinit reboot-sysv">
<primary sortas="b-reboot">reboot</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="runlevel-sysv">
<term><command>runlevel</command></term>
<listitem>
<para>Reports the previous and the current run-level, as noted in the
last run-level record in <filename>/run/utmp</filename></para>
<indexterm zone="ch-system-sysvinit runlevel-sysv">
<primary sortas="b-runlevel">runlevel</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="shutdown-sysv">
<term><command>shutdown</command></term>
<listitem>
<para>Brings the system down in a secure way, signaling all processes
and notifying all logged-in users</para>
<indexterm zone="ch-system-sysvinit shutdown-sysv">
<primary sortas="b-shutdown">shutdown</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="telinit-sysv">
<term><command>telinit</command></term>
<listitem>
<para>Tells <command>init</command> which run-level to change to</para>
<indexterm zone="ch-system-sysvinit telinit-sysv">
<primary sortas="b-telinit">telinit</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>