[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[1770019] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
---|
[673b0d8] | 3 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 4 | %general-entities;
|
---|
| 5 | ]>
|
---|
[3be4d97] | 6 | <sect1 id="ch-scripts-usage">
|
---|
[bce08ef] | 7 | <title>How Do These Bootscripts Work?</title>
|
---|
[673b0d8] | 8 | <?dbhtml filename="usage.html"?>
|
---|
| 9 |
|
---|
[81fd230] | 10 | <indexterm zone="ch-scripts-usage">
|
---|
| 11 | <primary sortas="a-Bootscripts">Bootscripts</primary>
|
---|
| 12 | <secondary>usage</secondary></indexterm>
|
---|
[0ad6d9a] | 13 |
|
---|
[b568bbaf] | 14 | <para>Linux uses a special booting facility named SysVinit that is based on a
|
---|
| 15 | concept of <emphasis>run-levels</emphasis>. It can be quite different from one
|
---|
| 16 | system to another, so it cannot be assumed that because things worked in one
|
---|
| 17 | particular Linux distribution, they should work the same in LFS too. LFS has its
|
---|
| 18 | own way of doing things, but it respects generally accepted standards.</para>
|
---|
[81fd230] | 19 |
|
---|
[b568bbaf] | 20 | <para>SysVinit (which will be referred to as <quote>init</quote> from now on)
|
---|
[b8a3fb2] | 21 | works using a run-levels scheme. There are seven (numbered 0 to 6) run-levels
|
---|
[b568bbaf] | 22 | (actually, there are more run-levels, but they are for special cases and are
|
---|
[37428334] | 23 | generally not used. See <filename>init(8)</filename> for more details), and each one
|
---|
[b568bbaf] | 24 | of those corresponds to the actions the computer is supposed to perform when it
|
---|
| 25 | starts up. The default run-level is 3. Here are the descriptions of the
|
---|
| 26 | different run-levels as they are implemented:</para>
|
---|
[81fd230] | 27 |
|
---|
| 28 | <literallayout>0: halt the computer
|
---|
| 29 | 1: single-user mode
|
---|
| 30 | 2: multi-user mode without networking
|
---|
| 31 | 3: multi-user mode with networking
|
---|
| 32 | 4: reserved for customization, otherwise does the same as 3
|
---|
| 33 | 5: same as 4, it is usually used for GUI login (like X's <command>xdm</command> or KDE's <command>kdm</command>)
|
---|
| 34 | 6: reboot the computer</literallayout>
|
---|
| 35 |
|
---|
| 36 | <para>The command used to change run-levels is <command>init
|
---|
| 37 | <replaceable>[runlevel]</replaceable></command>, where
|
---|
[b568bbaf] | 38 | <replaceable>[runlevel]</replaceable> is the target run-level. For example, to
|
---|
| 39 | reboot the computer, a user could issue the <command>init 6</command> command,
|
---|
| 40 | which is an alias for the <command>reboot</command> command. Likewise,
|
---|
| 41 | <command>init 0</command> is an alias for the <command>halt</command>
|
---|
| 42 | command.</para>
|
---|
[81fd230] | 43 |
|
---|
| 44 | <para>There are a number of directories under <filename
|
---|
| 45 | class="directory">/etc/rc.d</filename> that look like <filename
|
---|
[b568bbaf] | 46 | class="directory">rc?.d</filename> (where ? is the number of the run-level) and
|
---|
| 47 | <filename class="directory">rcsysinit.d</filename>, all containing a number of
|
---|
| 48 | symbolic links. Some begin with a <emphasis>K</emphasis>, the others begin with
|
---|
| 49 | an <emphasis>S</emphasis>, and all of them have two numbers following the
|
---|
| 50 | initial letter. The K means to stop (kill) a service and the S means to start a
|
---|
| 51 | service. The numbers determine the order in which the scripts are run, from 00
|
---|
| 52 | to 99—the lower the number the earlier it gets executed. When
|
---|
| 53 | <command>init</command> switches to another run-level, the appropriate services
|
---|
| 54 | are either started or stopped, depending on the runlevel chosen.</para>
|
---|
[81fd230] | 55 |
|
---|
| 56 | <para>The real scripts are in <filename
|
---|
| 57 | class="directory">/etc/rc.d/init.d</filename>. They do the actual
|
---|
| 58 | work, and the symlinks all point to them. Killing links and starting
|
---|
| 59 | links point to the same script in <filename
|
---|
| 60 | class="directory">/etc/rc.d/init.d</filename>. This is because the
|
---|
| 61 | scripts can be called with different parameters like
|
---|
| 62 | <parameter>start</parameter>, <parameter>stop</parameter>,
|
---|
| 63 | <parameter>restart</parameter>, <parameter>reload</parameter>, and
|
---|
| 64 | <parameter>status</parameter>. When a K link is encountered, the
|
---|
| 65 | appropriate script is run with the <parameter>stop</parameter>
|
---|
| 66 | argument. When an S link is encountered, the appropriate script is run
|
---|
| 67 | with the <parameter>start</parameter> argument.</para>
|
---|
| 68 |
|
---|
| 69 | <para>There is one exception to this explanation. Links that start
|
---|
| 70 | with an <emphasis>S</emphasis> in the <filename
|
---|
| 71 | class="directory">rc0.d</filename> and <filename
|
---|
| 72 | class="directory">rc6.d</filename> directories will not cause anything
|
---|
| 73 | to be started. They will be called with the parameter
|
---|
| 74 | <parameter>stop</parameter> to stop something. The logic behind this
|
---|
| 75 | is that when a user is going to reboot or halt the system, nothing
|
---|
| 76 | needs to be started. The system only needs to be stopped.</para>
|
---|
| 77 |
|
---|
| 78 | <para>These are descriptions of what the arguments make the scripts
|
---|
| 79 | do:</para>
|
---|
| 80 |
|
---|
| 81 | <variablelist>
|
---|
| 82 | <varlistentry>
|
---|
| 83 | <term><parameter>start</parameter></term>
|
---|
| 84 | <listitem><para>The service is started.</para></listitem>
|
---|
| 85 | </varlistentry>
|
---|
| 86 |
|
---|
| 87 | <varlistentry>
|
---|
| 88 | <term><parameter>stop</parameter></term>
|
---|
| 89 | <listitem><para>The service is stopped.</para></listitem>
|
---|
| 90 | </varlistentry>
|
---|
| 91 |
|
---|
| 92 | <varlistentry>
|
---|
| 93 | <term><parameter>restart</parameter></term>
|
---|
| 94 | <listitem><para>The service is stopped and then started again.</para></listitem>
|
---|
| 95 | </varlistentry>
|
---|
| 96 |
|
---|
| 97 | <varlistentry>
|
---|
| 98 | <term><parameter>reload</parameter></term>
|
---|
| 99 | <listitem><para>The configuration of the service is updated.
|
---|
| 100 | This is used after the configuration file of a service was modified, when
|
---|
| 101 | the service does not need to be restarted.</para></listitem>
|
---|
| 102 | </varlistentry>
|
---|
| 103 |
|
---|
| 104 | <varlistentry>
|
---|
| 105 | <term><parameter>status</parameter></term>
|
---|
| 106 | <listitem><para>Tells if the service is running and with which PIDs.</para></listitem>
|
---|
| 107 | </varlistentry>
|
---|
| 108 | </variablelist>
|
---|
| 109 |
|
---|
| 110 | <para>Feel free to modify the way the boot process works (after all,
|
---|
| 111 | it is your own LFS system). The files given here are an example of how
|
---|
| 112 | it can be done.</para>
|
---|
[0ad6d9a] | 113 |
|
---|
| 114 | </sect1>
|
---|
[81fd230] | 115 |
|
---|