2004-05-03 11:59:46 +01:00
<?xml version="1.0" encoding="ISO-8859-1"?>
< !DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
2004-01-27 22:29:49 +00:00
<sect1 id= "ch-system-sysvinit" xreflabel= "Sysvinit" >
2004-05-03 11:59:46 +01:00
<title > Sysvinit-&sysvinit-version; </title>
<?dbhtml filename="sysvinit.html"?>
<indexterm zone= "ch-system-sysvinit" > <primary sortas= "a-Sysvinit" > Sysvinit</primary> </indexterm>
2001-01-24 00:31:17 +00:00
2004-01-12 23:23:50 +00:00
<para > The Sysvinit package contains programs for controlling the startup,
running, and shutdown of your system.</para>
2004-05-03 11:59:46 +01:00
<screen > &buildtime; 0.1 SBU
&diskspace; 0.9 MB</screen>
<para > Sysvinit installation depends on: Binutils, Coreutils, GCC, Glibc, Make.</para>
2001-07-17 19:51:18 +01:00
2003-11-01 22:31:50 +00:00
<sect2 >
<title > Installation of Sysvinit</title>
2004-05-03 11:59:46 +01:00
<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 shouldn't 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, you can modify the source so that these messages read like
<quote > Sending processes started by init the TERM signal</quote> instead:</para>
2003-11-01 22:31:50 +00:00
<screen > <userinput > cp src/init.c{,.backup}
2003-11-18 03:25:40 +00:00
sed 's/Sending processes/& started by init/g' \
2004-05-03 11:59:46 +01:00
src/init.c.backup > src/init.c</userinput> </screen>
2003-11-01 22:31:50 +00:00
<para > Compile Sysvinit:</para>
<screen > <userinput > make -C src</userinput> </screen>
2004-05-03 11:59:46 +01:00
<para > Then install it:</para>
2003-11-01 22:31:50 +00:00
<screen > <userinput > make -C src install</userinput> </screen>
</sect2>
2004-01-12 23:23:50 +00:00
2004-02-09 22:45:54 +00:00
2004-05-03 11:59:46 +01:00
<sect2 id= "conf-sysvinit" > <title > Configuring Sysvinit</title>
<indexterm zone= "conf-sysvinit" >
<primary sortas= "a-Sysvinit" > Sysvinit</primary>
<secondary > configuring</secondary> </indexterm>
<indexterm zone= "conf-sysvinit" > <primary sortas= "e-/etc/inittab" > /etc/inittab</primary> </indexterm>
2004-02-09 22:45:54 +00:00
<para > Create a new <filename > /etc/inittab</filename> file by running the
following:</para>
<screen > <userinput > cat > /etc/inittab < < "EOF"</userinput>
# Begin /etc/inittab
id:3:initdefault:
si::sysinit:/etc/rc.d/init.d/rc sysinit
l0:0:wait:/etc/rc.d/init.d/rc 0
l1:S1:wait:/etc/rc.d/init.d/rc 1
l2:2:wait:/etc/rc.d/init.d/rc 2
l3:3:wait:/etc/rc.d/init.d/rc 3
l4:4:wait:/etc/rc.d/init.d/rc 4
l5:5:wait:/etc/rc.d/init.d/rc 5
l6:6:wait:/etc/rc.d/init.d/rc 6
ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -r now
su:S016:once:/sbin/sulogin
2004-05-06 17:22:04 +01:00
1:2345:respawn:/sbin/agetty -I '\033(K' tty1 9600
2:2345:respawn:/sbin/agetty -I '\033(K' tty2 9600
3:2345:respawn:/sbin/agetty -I '\033(K' tty3 9600
4:2345:respawn:/sbin/agetty -I '\033(K' tty4 9600
5:2345:respawn:/sbin/agetty -I '\033(K' tty5 9600
6:2345:respawn:/sbin/agetty -I '\033(K' tty6 9600
2004-02-09 22:45:54 +00:00
# End /etc/inittab
<userinput > EOF</userinput> </screen>
2004-05-06 17:22:04 +01:00
<para > The -I '\033(K' switch tells agetty to send this escape sequence to
the terminal before doing anything else. This escape sequence switches the
console character set to a user-defined one, which can be modified by
running the <command > setfont</command> program.
Actually, the <command > console</command> initscript from the LFS-Bootscripts
package calls the <command > setfont</command> program during system
startup. Sending this escape sequence is necessary for
people who use non-ISO-8859-1 screen font, but does not hurt native English
speakers.</para>
2004-02-09 22:45:54 +00:00
</sect2>
2004-01-12 23:23:50 +00:00
2004-05-03 11:59:46 +01:00
<sect2 id= "contents-sysvinit" > <title > Contents of Sysvinit</title>
<para > <emphasis > Installed programs</emphasis> : halt, init, killall5, last,
lastb (link to last), mesg, pidof (link to killall5), poweroff (link to halt),
reboot (link to halt), runlevel, shutdown, sulogin, telinit (link to init),
utmpdump and wall</para>
</sect2>
<sect2 > <title > Short descriptions</title>
<indexterm zone= "ch-system-sysvinit halt" > <primary sortas= "b-halt" > halt</primary> </indexterm>
<para id= "halt" > <command > halt</command> normally invokes shutdown with the -h flag,
except when already in run-level 0, then it tells the kernel to halt the system.
But first it notes in the file <filename > /var/log/wtmp</filename> that the
system is being brought down.</para>
<indexterm zone= "ch-system-sysvinit init" > <primary sortas= "b-init" > init</primary> </indexterm>
<para id= "init" > <command > init</command> is the mother of all processes. It reads its
commands from <filename > /etc/inittab</filename> , which normally tell it which
scripts to run for which run-level, and how many gettys to spawn.</para>
<indexterm zone= "ch-system-sysvinit killall5" > <primary sortas= "b-killall5" > killall5</primary> </indexterm>
<para id= "killall5" > <command > killall5</command> sends a signal to all processes, except
the processes in its own session -- so it won't kill the shell running the
script that called it.</para>
<indexterm zone= "ch-system-sysvinit last" > <primary sortas= "b-last" > last</primary> </indexterm>
<para id= "last" > <command > last</command> shows which users last logged in (and out),
searching back through the file <filename > /var/log/wtmp</filename> . It can
also show system boots and shutdowns, and run-level changes.</para>
<indexterm zone= "ch-system-sysvinit lastb" > <primary sortas= "b-lastb" > lastb</primary> </indexterm>
<para id= "lastb" > <command > lastb</command> shows the failed login attempts, as logged
in <filename > /var/log/btmp</filename> .</para>
<indexterm zone= "ch-system-sysvinit mesg" > <primary sortas= "b-mesg" > mesg</primary> </indexterm>
<para id= "mesg" > <command > mesg</command> controls whether other users can send
messages to the current user's terminal.</para>
2003-11-01 22:31:50 +00:00
2004-05-03 11:59:46 +01:00
<indexterm zone= "ch-system-sysvinit pidof" > <primary sortas= "b-pidof" > pidof</primary> </indexterm>
<para id= "pidof" > <command > pidof</command> reports the PIDs of the given programs.</para>
<indexterm zone= "ch-system-sysvinit poweroff" > <primary sortas= "b-poweroff" > poweroff</primary> </indexterm>
<para id= "poweroff" > <command > poweroff</command> tells the kernel to halt the system and
switch off the computer. But see halt.</para>
<indexterm zone= "ch-system-sysvinit reboot" > <primary sortas= "b-reboot" > reboot</primary> </indexterm>
<para id= "reboot" > <command > reboot</command> tells the kernel to reboot the system.
But see halt.</para>
<indexterm zone= "ch-system-sysvinit runlevel" > <primary sortas= "b-runlevel" > runlevel</primary> </indexterm>
<para id= "runlevel" > <command > runlevel</command> reports the previous and the current
run-level, as noted in the last run-level record in
<filename > /var/run/utmp</filename> .</para>
<indexterm zone= "ch-system-sysvinit shutdown" > <primary sortas= "b-shutdown" > shutdown</primary> </indexterm>
<para id= "shutdown" > <command > shutdown</command> brings the system down in a secure way,
signaling all processes and notifying all logged-in users.</para>
<indexterm zone= "ch-system-sysvinit sulogin" > <primary sortas= "b-sulogin" > sulogin</primary> </indexterm>
<para id= "sulogin" > <command > sulogin</command> allows the superuser to log in. It is
normally invoked by init when the system goes into single user mode.</para>
<indexterm zone= "ch-system-sysvinit telinit" > <primary sortas= "b-telinit" > telinit</primary> </indexterm>
<para id= "telinit" > <command > telinit</command> tells init which run-level to enter.</para>
<indexterm zone= "ch-system-sysvinit utmpdump" > <primary sortas= "b-utmpdump" > utmpdump</primary> </indexterm>
<para id= "utmpdump" > <command > utmpdump</command> displays the content of the given login
file in a friendlier format.</para>
<indexterm zone= "ch-system-sysvinit wall" > <primary sortas= "b-wall" > wall</primary> </indexterm>
<para id= "wall" > <command > wall</command> writes a message to all logged-in users.</para>
</sect2>
</sect1>