glfs/pst/printing/lprng.xml
Randy McMurchy 0aeb69629f Added a comment to each file that may need a mention of a test suite added to it, this allows closing of bug #1697
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5951 af4574ff-66df-0310-9fd7-8a98e5e911e0
2006-04-27 10:48:30 +00:00

316 lines
10 KiB
XML

<?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>
<keywordset>
<keyword role="package">LPRng-&LPRng-version;.tar</keyword>
<keyword role="ftpdir">LPRng</keyword>
</keywordset>
</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>./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="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>