Ignore:
Timestamp:
06/14/2004 03:45:00 AM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
5d1668d
Parents:
d8a5def6
Message:

XML update for Chapter 41

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2318 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/printing/cups.xml

    rd8a5def6 r73ddd1a0  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY cups-download-http "http://multivac.cwru.edu/mirror/packages/cups-&cups-version;-source.tar.bz2">
     7  <!ENTITY cups-download-ftp  "ftp://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
     8  <!ENTITY cups-size          "3.7 MB">
     9  <!ENTITY cups-buildsize     "24 MB">
     10  <!ENTITY cups-time          "0.67 SBU">
     11]>
     12
    113<sect1 id="cups" xreflabel="CUPS-&cups-version;">
    214<?dbhtml filename="cups.html"?>
    315<title>CUPS-&cups-version;</title>
    416
    5 &cups-intro;
    6 &cups-inst;
    7 &cups-exp;
    8 &cups-config;
    9 &cups-desc;
     17<sect2>
     18<title>Introduction to
     19<application><acronym>CUPS</acronym></application></title>
     20
     21<para>The Common Unix Printing System (<acronym>CUPS</acronym>) is a print spooler and
     22associated utilities. It is based on the "Internet Printing Protocol"
     23and provides printing services to most PostScript and
     24raster printers.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&cups-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&cups-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &cups-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &cups-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &cups-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title><application><acronym>CUPS</acronym></application> dependencies</title>
     36<sect4><title>Optional</title>
     37<para><xref linkend="libjpeg"/>, <xref linkend="libpng"/>,
     38<xref linkend="libtiff"/>, <xref linkend="openssl"/> or
     39<ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink> (which
     40needs <ulink
     41url="ftp://ftp.gnupg.org/gcrypt/alpha/libgpg-error/">libgpg-error</ulink>,
     42<ulink url="ftp://ftp.gnupg.org/gcrypt/libgcrypt/">libgcrypt</ulink> and
     43<ulink
     44url="ftp://ftp.gnupg.org/gcrypt/alpha/gnutls/opencdk/">opencdk</ulink>,
     45in that order.), <xref linkend="Linux_PAM"/>, <xref linkend="php"/> and <xref
     46linkend="Python"/></para></sect4>
     47</sect3>
     48
     49</sect2>
     50
     51<sect2>
     52<title>Installation of
     53<application><acronym>CUPS</acronym></application></title>
     54
     55<para>Install <application><acronym>CUPS</acronym></application> by
     56running the following commands:</para>
     57
     58<screen><userinput><command>./configure &amp;&amp;
     59make &amp;&amp;
     60make install</command></userinput></screen>
     61
     62</sect2>
     63
     64<sect2>
     65<title>Command explanations</title>
     66
     67<para>The basic default behavior of the installation is appropriate for
     68<acronym>LFS</acronym> systems. <application><acronym>CUPS</acronym>
     69</application> files are placed in <filename
     70class="directory">/usr/bin</filename>, <filename class="directory">/usr/sbin</filename>, <filename
     71class="directory">/var</filename> and <filename class="directory">/etc/cups</filename>.</para>
     72
     73</sect2>
     74
     75<sect2>
     76<title>Configuring <application><acronym>CUPS</acronym></application></title>
     77
     78<para>Configuration of <application><acronym>CUPS</acronym></application> is
     79dependent on the type of printer and can be complex. Generally, PostScript
     80printers are easier. For detailed instructions on configuration and use of
     81<application><acronym>CUPS</acronym></application>, see
     82<ulink url="http://www.cups.org/documentation.php"/>. The Software
     83Administrators Manual and Software Users Manual are particularly useful.</para>
     84
     85<para>For non-PostScript printers to print with CUPS, you need to install
     86<xref linkend="espgs"/> to convert PostScript to raster images
     87and a driver (e.g., from <xref linkend="gimp-print"/>) to convert
     88the resulting raster images to a form that the printer understands.
     89<ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
     90drivers use Ghostscript to convert PostScript to a printable form directly, but this
     91is considered to be a hack by <application><acronym>CUPS</acronym></application>
     92developers.</para>
     93
     94<para>During the install, <application><acronym>CUPS</acronym></application>
     95created the startup file <filename>/etc/rc.d/init.d/cups</filename>. The file
     96works, but you may want to change it to a more conventional <acronym>LFS
     97</acronym> startup file by installing the script included in the
     98<xref linkend="intro-important-bootscripts"/> package:</para>
     99
     100<screen><userinput><command>make install-cups</command></userinput></screen>
     101
     102</sect2>
     103
     104<sect2>
     105<title>Contents</title>
     106
     107<para><application><acronym>CUPS</acronym></application> provides
     108<command>accept</command>,
     109<command>cupsaddsmb</command>,
     110<command>cupsd</command>,
     111<command>cupstestppd</command>,
     112<command>lpadmin</command>,
     113<command>lpc</command>,
     114<command>lpinfo</command>,
     115<command>lpmove</command>,
     116<command>reject</command>,
     117<command>cancel</command>,
     118<command>cups-config</command>,
     119<command>disable</command>,
     120<command>enable</command>,
     121<command>lp</command>,
     122<command>lpoptions</command>,
     123<command>lppasswd</command>,
     124<command>lpq</command>,
     125<command>lpr</command>,
     126<command>lprm</command>,
     127<command>lpstat</command>,
     128<filename class="libraryfile">libcups</filename>,
     129<filename class="libraryfile">libcupsimage</filename> and various
     130scripts and filters.</para>
     131
     132<sect3><title>lpc</title>
     133<para><command>lpc</command> provides limited control over printer
     134and class queues provided by <application><acronym>CUPS</acronym>
     135</application>.</para></sect3>
     136
     137<sect3><title>cupsd</title>
     138<para><command>cupsd</command> is the scheduler for the Common Unix Printing System.
     139</para></sect3>
     140
     141<sect3><title>accept</title>
     142<para><command>accept</command> instructs the printing system to accept print jobs to the specified destinations.
     143</para></sect3>
     144
     145<sect3><title>reject</title>
     146<para><command>reject</command> instructs the printing system to
     147reject print jobs to the specified destinations.
     148</para></sect3>
     149
     150<sect3><title>cupsaddsmb</title>
     151<para><command>cupsaddsmb</command> exports printers to the SAMBA software for
     152use with Windows clients.
     153</para></sect3>
     154
     155<sect3><title>lpadmin</title>
     156<para><command>lpadmin</command> configures printer and class queues provided by
     157<acronym>CUPS</acronym>.
     158</para></sect3>
     159
     160<sect3><title>lpinfo</title>
     161<para><command>lpinfo</command> lists the available devices or drivers known to
     162the <acronym>CUPS</acronym> server.
     163</para></sect3>
     164
     165<sect3><title>lpmove</title>
     166<para><command>lpmove</command> moves the specified job to a new destination.
     167</para></sect3>
     168
     169<sect3><title>cupstestppd</title>
     170<para><command>cupstestppd</command> tests the conformance of
     171<filename>PPD</filename> files.
     172</para></sect3>
     173
     174<sect3><title>lpq</title>
     175<para><command>lpq</command> shows the current print queue status on the named printer.
     176</para></sect3>
     177
     178<sect3><title>lpr</title>
     179<para><command>lpr</command> submits files for printing.
     180</para></sect3>
     181
     182<sect3><title>lprm</title>
     183<para><command>lprm</command> cancels print jobs that have been queued for printing.
     184</para></sect3>
     185
     186<sect3><title>cancel</title>
     187<para><command>cancel</command> cancels existing print jobs.
     188</para></sect3>
     189
     190<sect3><title>disable</title>
     191<para><command>disable</command> stops the named printers or classes.
     192</para></sect3>
     193
     194<sect3><title>enable</title>
     195<para><command>enable</command> starts the named printers or classes.
     196</para></sect3>
     197
     198<sect3><title>lp</title>
     199<para><command>lp</command> submits files for printing or alters a pending job.
     200</para></sect3>
     201
     202<sect3><title>lpoptions</title>
     203<para><command>lpoptions</command> displays or sets printer options and defaults.
     204</para></sect3>
     205
     206<sect3><title>lpstat</title>
     207<para><command>lpstat</command> displays status information about the
     208current classes, jobs, and printers.</para></sect3>
     209
     210<sect3><title>lppasswd</title>
     211<para><command>lppasswd</command> adds, changes or deletes passwords in
     212the <application><acronym>CUPS</acronym></application> digest password file
     213<filename>passwd.md5</filename>.
     214</para></sect3>
     215
     216<sect3><title>cups-config</title>
     217<para><command>cups-config</command> is the <application><acronym>CUPS
     218</acronym></application> program configuration utility.
     219</para></sect3>
     220
     221</sect2>
    10222
    11223</sect1>
Note: See TracChangeset for help on using the changeset viewer.