source: pst/printing/lprng.xml@ 276015d2

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY LPRng-download-http "http://www.lprng.com/DISTRIB/LPRng/LPRng-&LPRng-version;.tgz">
  <!ENTITY LPRng-download-ftp  "ftp://ftp.lprng.com/pub/LPRng/LPRng/LPRng-&LPRng-version;.tgz">
  <!ENTITY LPRng-md5sum        "1b3a0abd291b260eab6087ac0e61ed84">
  <!ENTITY LPRng-size          "10.2 MB">
  <!ENTITY LPRng-buildsize     "71.8 MB">
  <!ENTITY LPRng-time          "0.42 SBU">
]>

<sect1 id="LPRng" xreflabel="LPRng-&LPRng-version;">
  <?dbhtml filename="LPRng.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LPRng-&LPRng-version;</title>

  <indexterm zone="LPRng">
    <primary sortas="a-LPRng">LPRng</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to LPRng</title>

    <para>The <application>LPRng</application> package contains an enhanced,
    extended and portable implementation of the Berkeley Line PRinter (LPR)
    print spooler. This is useful for queuing print jobs.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&LPRng-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&LPRng-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &LPRng-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &LPRng-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &LPRng-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &LPRng-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">LPRng Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="openssl"/>,
    <xref linkend="tcpwrappers"/>,
    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
    and <ulink url="http://www.pdc.kth.se/kth-krb/">krb4</ulink></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/lprng"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of LPRng</title>

    <para>Install <application>LPRng</application> by running
    the following commands:</para>

<screen><userinput>sed -i 's@CLEAR,0@CLEAR,CLEAR,NULL@' src/common/lpq.c &amp;&amp;
sed -i 's@\(fi\|done\) \\@\1; \\@' Makefile.in &amp;&amp;
./configure --prefix=/usr --libexecdir=/usr/lib/lprng \
    --sysconfdir=/etc --enable-shared &amp;&amp;
make</userinput></screen>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install
install -v -d -m755 /usr/share/doc/lprng-&LPRng-version; &amp;&amp;
cp -v -R DOCS/* PrintingCookbook \
    /usr/share/doc/lprng-&LPRng-version;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sed -i 's@CLEAR ...'</command>:  This fixes a gcc-4.1 warning,
    treated as an error.</para>
    <para><command>sed -i 's@/\(fi ...'</command>:  This fixes a syntax bug for
    newer makes.</para>

  </sect2>

  <sect2 role="configuration">
    <title>Configuring LPRng</title>

    <sect3 id="lprng-config">
      <title>Config Files</title>

      <para><filename>/etc/printcap</filename> and
      <filename>/etc/lpd/*</filename></para>

      <indexterm zone="LPRng lprng-config">
        <primary sortas="e-etc-printcap">/etc/printcap</primary>
      </indexterm>

      <indexterm zone="LPRng lprng-config">
        <primary sortas="e-etc-lpd-star">/etc/lpd/*</primary>
      </indexterm>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para>There is no generic <filename>printcap</filename> for all printers.
      A sample printcap is loaded into the <filename
      class="directory">/etc</filename> directory which can be of some help.
      Information is also available at <ulink url="http://www.lprng.org"/>,
      <ulink url="http://www.linuxprinting.org"/> and the documentation
      installed in <filename
      class='directory'>/usr/share/doc/lprng-&LPRng-version;</filename>.</para>

    </sect3>

    <sect3  id="lprng-init">
      <title>Boot Script</title>

      <para>The init script installed by <application>LPRng</application>
      is not consistent with other BLFS scripts; therefore, install the
      <filename>/etc/rc.d/init.d/lprng</filename> init script included in
      the <xref linkend="bootscripts"/> package (as the
      <systemitem class="username">root</systemitem> user):</para>

      <indexterm zone="LPRng lprng-init">
        <primary sortas="f-lprng">lprng</primary>
      </indexterm>

<screen role="root"><userinput>make install-lprng</userinput></screen>

      <note>
        <para>You may also want to remove the <command>lpd</command>
        script that was installed in
        <filename class='directory'>/etc/rc.d/init.d</filename>.</para>
      </note>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

        <seglistitem>
        <seg>cancel, checkpc, lp, lpc, lpd, lpq, lpr, lprm, lprng_certs,
        lprng_index_certs, and lpstat</seg>
        <seg>liblpr.{so,a}</seg>
        <seg>/etc/lpd, /usr/lib/lprng, /usr/share/doc/&LPRng-version;,
        /var/run/lpd, and /var/spool/lpd</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="cancel">
        <term><command>cancel</command></term>
        <listitem>
          <para>is a symlink to <command>lprm</command> used to send cancel
          requests to an <application>LPRng</application> print service.</para>
          <indexterm zone="LPRng cancel">
            <primary sortas="b-cancel">cancel</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="checkpc">
        <term><command>checkpc</command></term>
        <listitem>
          <para>checks out the printcap database.</para>
          <indexterm zone="LPRng checkpc">
            <primary sortas="b-checkpc">checkpc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lp">
        <term><command>lp</command></term>
        <listitem>
          <para>is a symlink to <command>lpr</command> used to send requests
          to an <application>LPRng</application> print service.</para>
          <indexterm zone="LPRng lp">
            <primary sortas="b-lp">lp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lpc">
        <term><command>lpc</command></term>
        <listitem>
          <para>is a control program for the <command>lpd</command>
          daemon.</para>
          <indexterm zone="LPRng lpc">
            <primary sortas="b-lpc">lpc</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lpd">
        <term><command>lpd</command></term>
        <listitem>
          <para>is the print queueing daemon.</para>
          <indexterm zone="LPRng lpd">
            <primary sortas="b-lpd">lpd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lpq">
        <term><command>lpq</command></term>
        <listitem>
          <para>is a status monitoring program.</para>
          <indexterm zone="LPRng lpq">
            <primary sortas="b-lpq">lpq</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lpr">
        <term><command>lpr</command></term>
        <listitem>
          <para>is a print job spooler program.</para>
          <indexterm zone="LPRng lpr">
            <primary sortas="b-lpr">lpr</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lprm">
        <term><command>lprm</command></term>
        <listitem>
          <para>is a print job removal program.</para>
          <indexterm zone="LPRng lprm">
            <primary sortas="b-lprm">lprm</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lprng_certs">
        <term><command>lprng_certs</command></term>
        <listitem>
          <para>is a program used to manage SSL certificates for the
          <application>LPRng</application> software.</para>
          <indexterm zone="LPRng lprng_certs">
            <primary sortas="b-lprng_certs">lprng_certs</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lprng_index_certs">
        <term><command>lprng_index_certs</command></term>
        <listitem>
          <para>creates a set of index files in the
          <application>LPRng</application> signing certificate directory.</para>
          <indexterm zone="LPRng lprng_index_certs">
            <primary sortas="b-lprng_index_certs">lprng_index_certs</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="lpstat">
        <term><command>lpstat</command></term>
        <listitem>
          <para>is a print job status reporting program.</para>
          <indexterm zone="LPRng lpstat">
            <primary sortas="b-lpstat">lpstat</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="liblpr">
        <term><filename class='libraryfile'>liblpr.{so,a}</filename></term>
        <listitem>
          <para>contains the API functions used by the
          <application>LPRng</application> programs.</para>
          <indexterm zone="LPRng liblpr">
            <primary sortas="c-liblpr">liblpr.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>