source: pst/printing/cups.xml@ 24ebcaa8

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.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
Last change on this file since 24ebcaa8 was 24ebcaa8, checked in by Randy McMurchy <randy@…>, 17 years ago

Fixed broken download URLs in the NAS, libmikmod, OpenOffice, SANE Backends, ESP Ghostscript and CUPS instructions

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

  • Property mode set to 100644
File size: 16.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY cups-download-http "http://ftp2.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
8 <!ENTITY cups-download-ftp "ftp://ftp3.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
9 <!ENTITY cups-md5sum "bf44783d9b46130bee9f2995e6055470">
10 <!ENTITY cups-size "3.5 MB">
11 <!ENTITY cups-buildsize "55 MB">
12 <!ENTITY cups-time "0.6 SBU">
13]>
14
15<sect1 id="cups" xreflabel="CUPS-&cups-version;">
16 <?dbhtml filename="cups.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>CUPS-&cups-version;</title>
24
25 <indexterm zone="cups">
26 <primary sortas="a-CUPS">CUPS</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to CUPS</title>
31
32 <para>The Common Unix Printing System (CUPS) is a print spooler and
33 associated utilities. It is based on the "Internet Printing
34 Protocol" and provides printing services to most PostScript and raster
35 printers.</para>
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&cups-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&cups-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &cups-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &cups-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &cups-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &cups-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <!--
60 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
61 <itemizedlist spacing="compact">
62 <listitem>
63 <para>Recommended patch: <ulink
64 url="&patch-root;/cups-&cups-version;-testsuite_fix-1.patch"/></para>
65 </listitem>
66 </itemizedlist>
67 -->
68
69 <bridgehead renderas="sect3">CUPS Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Recommended</bridgehead>
72 <para role="recommended"><xref linkend="libjpeg"/>,
73 <xref linkend="libpng"/>,
74 and <xref linkend="libtiff"/></para>
75
76 <bridgehead renderas="sect4">Optional</bridgehead>
77 <para role="optional"><xref linkend="pkgconfig"/>,
78 <xref linkend="dbus"/>,
79 <xref linkend="openldap"/>,
80 <xref linkend="openssl"/> or
81 <ulink url="http://www.gnu.org/software/gnutls/">GnuTLS</ulink> (which needs
82 <ulink url="ftp://ftp.gnupg.org/gcrypt/alpha/libgpg-error/">
83 libgpg-error</ulink>,
84 <ulink url="ftp://ftp.gnupg.org/gcrypt/libgcrypt/">libgcrypt</ulink> and
85 <ulink url="ftp://ftp.gnupg.org/gcrypt/alpha/gnutls/opencdk/">opencdk</ulink>,
86 in that order),
87 <xref linkend="linux-pam"/>,
88 <xref linkend="php"/>,
89 <xref linkend="python"/>,
90 <xref linkend="jdk"/>,
91 <ulink url="http://www.openslp.org/">OpenSLP</ulink>,
92 <ulink url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
93 <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libacl</ulink>
94 (requires <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libattr</ulink>),
95 <ulink url="http://www.easysw.com/htmldoc/">HTMLDOC</ulink>, and
96 <ulink url="http://valgrind.kde.org/">Valgrind</ulink> (optionally used if
97 running the test suites)</para>
98
99 <para condition="html" role="usernotes">User Notes:
100 <ulink url="&blfs-wiki;/cups"/></para>
101
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of CUPS</title>
106
107 <para>Create an <systemitem class="username">lp</systemitem> user, as
108 <application>CUPS</application> will create some files owned by this user.
109 (The <systemitem class="username">lp</systemitem> user is the default used
110 by <application>CUPS</application>, but may be changed to a different user
111 by passing a parameter to the <command>configure</command> script.) Use the
112 following command as the <systemitem class="username">root</systemitem>
113 user:</para>
114
115<screen role="root"><userinput>useradd -c "Print Service User" -d /dev/null -g lp -s /bin/false -u 9 lp</userinput></screen>
116
117 <!--
118 <para>If you utilize <application>Linux-PAM</application>, you need to
119 modify some files so <application>CUPS</application> can find needed headers.
120 Make the appropriate modifications using the following command:</para>
121
122<screen><userinput>sed -i -e "s@pam/pam@security/pam@g" \
123{config-scripts/cups-pam.m4,scheduler/auth.c,configure}</userinput></screen>
124 -->
125
126 <!--
127 <para>If you plan on running the test suite, you should apply the patch
128 listed above to fix several issues in the test suite script. Note that if
129 you have the non-free <command>htmldoc</command> program installed, the
130 patch disables its use.</para>
131
132<screen><userinput>patch -Np1 -i ../cups-&cups-version;-testsuite_fix-1.patch</userinput></screen>
133 -->
134
135 <para>Install <application>CUPS</application> by running the
136 following commands:</para>
137
138<screen><userinput>./configure &amp;&amp;
139make</userinput></screen>
140
141 <para>To test the results, issue: <command>make check</command>. This will
142 run a basic test suite without any load testing. If you wish to run the
143 tests specifying non-default parameters, issue: <command>make test</command>.
144 Note that the <quote>torture load testing</quote> test uses more resources
145 than those displayed in the prompt.</para>
146
147 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
148
149<screen role="root"><userinput>make install</userinput></screen>
150
151 <para>The <application>man</application> files are installed in compressed
152 (<filename class='extension'>.gz</filename>) format. If desired, use the
153 following commands to uncompress them:</para>
154
155<screen role="root"><userinput>gunzip -v /usr/share/man/man{\
1561/{cancel,cups{-config,test{dsc,ppd}},\
157lp{,options,passwd,q,rm,r,stat}}.1,\
1585/{{classes,client,cups-snmp,cupsd,printers,subscriptions,mailto}.conf,\
159mime.{convs,types}}.5,\
1607/{backend,filter}.7,\
1618/{accept,cups{d,addsmb,enable,-{deviced,driverd,lpd,polld,}},\
162lp{admin,info,move,c}}.8}.gz &amp;&amp;
163
164rm -v /usr/share/man/man8/{reject,cupsdisable}.8.gz &amp;&amp;
165
166ln -v -s accept.8 /usr/share/man/man8/reject.8 &amp;&amp;
167ln -v -s cupsenable.8 /usr/share/man/man8/cupsdisable.8</userinput></screen>
168
169 </sect2>
170
171 <sect2 role="commands">
172 <title>Command Explanations</title>
173
174 <para>The basic default behavior of the installation is appropriate for
175 LFS systems. <application>CUPS</application> files are placed in
176 <filename class="directory">/usr/bin</filename>,
177 <filename class="directory">/usr/sbin</filename>,
178 <filename class="directory">/var</filename> and
179 <filename class="directory">/etc/cups</filename>.</para>
180
181 </sect2>
182
183 <sect2 role="configuration">
184 <title>Configuring CUPS</title>
185
186 <para>Configuration of <application>CUPS</application> is dependent on
187 the type of printer and can be complex. Generally, PostScript printers
188 are easier. For detailed instructions on configuration and use of
189 <application>CUPS</application>, see <ulink
190 url="http://www.cups.org/documentation.php"/>. The Software Administrators
191 Manual and Software Users Manual are particularly useful.</para>
192
193 <para>For non-PostScript printers to print with
194 <application>CUPS</application>, you need to install
195 <xref linkend="espgs"/> to convert PostScript to raster images
196 and a driver (e.g., from <xref linkend="gimp-print"/>) to convert
197 the resulting raster images to a form that the printer understands.
198 <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
199 drivers use Ghostscript to convert PostScript to a printable form directly,
200 but this is considered to be a hack by
201 <application>CUPS</application> developers.</para>
202
203 <sect3 id="cups-init">
204 <title>Boot Script</title>
205
206 <para>During the installation, <application>CUPS</application> added
207 startup files in <filename class="directory">/etc/rc.d</filename>.
208 These scripts will work in most cases, but will fail if you provide
209 printers to <application>Samba</application> clients. Additionally,
210 they are not consistent with standard LFS style scripts. Replace the
211 installed scripts with the scripts and symlinks included in the
212 <xref linkend="bootscripts"/> package:</para>
213
214 <indexterm zone="cups cups-init">
215 <primary sortas="f-cups">cups</primary>
216 </indexterm>
217
218<screen role="root"><userinput>make install-cups</userinput></screen>
219
220 </sect3>
221
222 </sect2>
223
224 <sect2 role="content">
225 <title>Contents</title>
226
227 <segmentedlist>
228 <segtitle>Installed Programs</segtitle>
229 <segtitle>Installed Libraries</segtitle>
230 <segtitle>Installed Directories</segtitle>
231
232 <seglistitem>
233 <seg>accept, cancel, cups-config, cupsaddsmb, cupsd, cupstestppd, disable,
234 enable, lp, lpadmin, lpc, lpinfo, lpmove, lpoptions, lppasswd, lpq, lpr,
235 lprm, lpstat, and reject</seg>
236 <seg>libcups.{so,a}, libcupsimage.{so,a}, and various filters and backend
237 drivers</seg>
238 <seg>/etc/cups, /usr/include/cups, /usr/lib/cups, /usr/share/doc/cups,
239 /usr/share/cups, /var/log/cups, and /var/spool/cups</seg>
240 </seglistitem>
241 </segmentedlist>
242
243 <variablelist>
244 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
245 <?dbfo list-presentation="list"?>
246 <?dbhtml list-presentation="table"?>
247
248 <varlistentry id="accept">
249 <term><command>accept</command></term>
250 <listitem>
251 <para>instructs the printing system to accept print jobs to the
252 specified destinations.</para>
253 <indexterm zone="cups accept">
254 <primary sortas="b-accept">accept</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="cancel-cups">
260 <term><command>cancel</command></term>
261 <listitem>
262 <para>cancels existing print jobs from the print queues.</para>
263 <indexterm zone="cups cancel-cups">
264 <primary sortas="b-cancel">cancel</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="cups-config">
270 <term><command>cups-config</command></term>
271 <listitem>
272 <para>is a <application>CUPS</application>
273 program configuration utility.</para>
274 <indexterm zone="cups cups-config">
275 <primary sortas="b-cups-config">cups-config</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="cupsaddsmb">
281 <term><command>cupsaddsmb</command></term>
282 <listitem>
283 <para>exports printers to the <application>Samba</application>
284 software for use with Windows clients.</para>
285 <indexterm zone="cups cupsaddsmb">
286 <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="cupsd">
292 <term><command>cupsd</command></term>
293 <listitem>
294 <para>is the scheduler for the Common Unix Printing System.</para>
295 <indexterm zone="cups cupsd">
296 <primary sortas="b-cupsd">cupsd</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="cupstestppd">
302 <term><command>cupstestppd</command></term>
303 <listitem>
304 <para>tests the conformance of PPD files.</para>
305 <indexterm zone="cups cupstestppd">
306 <primary sortas="b-cupstestppd">cupstestppd</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="disable">
312 <term><command>disable</command></term>
313 <listitem>
314 <para>stops the named printers or classes.</para>
315 <indexterm zone="cups disable">
316 <primary sortas="b-disable">disable</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="enable">
322 <term><command>enable</command></term>
323 <listitem>
324 <para>starts the named printers or classes.</para>
325 <indexterm zone="cups enable">
326 <primary sortas="b-enable">enable</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="lp-cups">
332 <term><command>lp</command></term>
333 <listitem>
334 <para>submits files for printing or alters a pending job.</para>
335 <indexterm zone="cups lp-cups">
336 <primary sortas="b-lp">lp</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="lpadmin">
342 <term><command>lpadmin</command></term>
343 <listitem>
344 <para>configures printer and class queues provided by
345 <application>CUPS</application>.</para>
346 <indexterm zone="cups lpadmin">
347 <primary sortas="b-lpadmin">lpadmin</primary>
348 </indexterm>
349 </listitem>
350 </varlistentry>
351
352 <varlistentry id="lpc-cups">
353 <term><command>lpc</command></term>
354 <listitem>
355 <para> provides limited control over printer and class queues
356 provided by <application>CUPS</application>.</para>
357 <indexterm zone="cups lpc-cups">
358 <primary sortas="b-lpc">lpc</primary>
359 </indexterm>
360 </listitem>
361 </varlistentry>
362
363 <varlistentry id="lpinfo">
364 <term><command>lpinfo</command></term>
365 <listitem>
366 <para>lists the available devices or drivers known to the
367 <application>CUPS</application> server.</para>
368 <indexterm zone="cups lpinfo">
369 <primary sortas="b-lpinfo">lpinfo</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="lpmove">
375 <term><command>lpmove</command></term>
376 <listitem>
377 <para>moves the specified job to a new destination.</para>
378 <indexterm zone="cups lpmove">
379 <primary sortas="b-lpmove">lpmove</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="lpoptions">
385 <term><command>lpoptions</command></term>
386 <listitem>
387 <para>displays or sets printer options and defaults.</para>
388 <indexterm zone="cups lpoptions">
389 <primary sortas="b-lpoptions">lpoptions</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="lppasswd">
395 <term><command>lppasswd</command></term>
396 <listitem>
397 <para>adds, changes or deletes passwords in the
398 <application>CUPS</application> digest password file
399 <filename>passwd.md5</filename>.</para>
400 <indexterm zone="cups lppasswd">
401 <primary sortas="b-lppasswd">lppasswd</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="lpq-cups">
407 <term><command>lpq</command></term>
408 <listitem>
409 <para>shows the current print queue status on the named printer.</para>
410 <indexterm zone="cups lpq-cups">
411 <primary sortas="b-lpq">lpq</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="lpr-cups">
417 <term><command>lpr</command></term>
418 <listitem>
419 <para>submits files for printing.</para>
420 <indexterm zone="cups lpr-cups">
421 <primary sortas="b-lpr">lpr</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="lprm-cups">
427 <term><command>lprm</command></term>
428 <listitem>
429 <para>cancels print jobs that have been queued for printing.</para>
430 <indexterm zone="cups lprm-cups">
431 <primary sortas="b-lprm">lprm</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="lpstat-cups">
437 <term><command>lpstat</command></term>
438 <listitem>
439 <para>displays status information about the current classes, jobs,
440 and printers.</para>
441 <indexterm zone="cups lpstat-cups">
442 <primary sortas="b-lpstat">lpstat</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="reject">
448 <term><command>reject</command></term>
449 <listitem>
450 <para>instructs the printing system to reject print jobs to the
451 specified destinations.</para>
452 <indexterm zone="cups reject">
453 <primary sortas="b-reject">reject</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 </variablelist>
459
460 </sect2>
461
462</sect1>
Note: See TracBrowser for help on using the repository browser.