source: pst/printing/cups.xml@ 5254d12

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 5254d12 was 5254d12, checked in by Randy McMurchy <randy@…>, 18 years ago

Standardized the id tag name of the Bootscripts package

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

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