source: clfs-embedded/BOOK/bootscripts/common/bootscripts.xml @ f96a570

<?xml version="1.0" encoding="ISO-8859-1"?>
<!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-scripts-bootscripts" role="wrap">
  <?dbhtml filename="bootscripts.html"?>

  <title>CLFS-Bootscripts-&clfs-bootscripts-version;</title>

  <indexterm zone="ch-scripts-bootscripts">
    <primary sortas="a-Bootscripts">Bootscripts</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The CLFS-Bootscripts package contains a set of scripts to
    start/stop the CLFS system at bootup/shutdown.</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of CLFS-Bootscripts</title>

    <important>

      <para>Unlike other chapters, after installing the bootscripts, do not 
      delete the bootscripts source directory.  The bootscripts source directory
      may be needed later.</para>

    </important>

    <para>Install the package:</para>

<screen><userinput>make DESTDIR=${CLFS}/targetfs install-bootscripts</userinput></screen>

    <para>The CLFS startup bootscript is <filename>/etc/rc.d/startup</filename>,
    but BusyBox will look for <filename>/etc/init.d/rcS</filename> to use as its
    startup script.  To ensure BusyBox finds the startup script, create the 
    <filename>${CLFS}/targetfs/etc/init.d</filename> directory and a symlink:</para>

<screen><userinput>install -dv ${CLFS}/targetfs/etc/init.d
ln -sv ../rc.d/startup ${CLFS}/targetfs/etc/init.d/rcS</userinput></screen>

  </sect2>

  <sect2 id="contents-bootscripts" role="content">
    <title>Contents of CLFS-Bootscripts</title>

    <segmentedlist>
      <segtitle>Installed scripts</segtitle>

      <seglistitem>
        <seg>bridge, functions, network, start, stop, and syslog.</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="bridge-bootscripts">
        <term><command>bridge</command></term>
        <listitem>
          <para>Sets up network bridging, if configured</para>
          <indexterm zone="ch-scripts-bootscripts bridge-bootscripts">
            <primary sortas="d-bridge">bridge</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="functions-bootscripts">
        <term><command>functions</command></term>
        <listitem>
          <para>Contains common functions, such as error and status checking,
          that are used by several bootscripts</para>
          <indexterm zone="ch-scripts-bootscripts functions-bootscripts">
            <primary sortas="d-functions">functions</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="network-bootscripts">
        <term><command>network</command></term>
        <listitem>
          <para>Sets up network interfaces, such as network cards, and sets up
          the default gateway (where applicable)</para>
          <indexterm zone="ch-scripts-bootscripts network-bootscripts">
            <primary sortas="d-network">network</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="syslog-bootscripts">
        <term><command>syslog</command></term>
        <listitem>
          <para>Starts and stops the system log daemons</para>
          <indexterm zone="ch-scripts-bootscripts syslog-bootscripts">
            <primary sortas="d-syslog">syslog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>