source: pst/printing/cups.xml@ fa3edfef

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since fa3edfef was fa3edfef, checked in by Pierre Labastie <pieere@…>, 4 years ago

Format pst

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22885 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 27.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY cups-download-http "https://github.com/apple/cups/releases/download/v&cups-version;/cups-&cups-version;-source.tar.gz">
8 <!ENTITY cups-download-ftp " ">
9 <!ENTITY cups-md5sum "8ad8897c97cf4d90f20dac4318f47421">
10 <!ENTITY cups-size "7.8 MB">
11 <!ENTITY cups-buildsize "64 MB (Add 42 MB for tests)">
12 <!ENTITY cups-time "0.5 SBU (Add 0.9 SBU for tests)">
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>
33 The Common Unix Printing System (CUPS) is a print spooler and
34 associated utilities. It is based on the "Internet Printing
35 Protocol" and provides printing services to most PostScript
36 and raster printers.
37 </para>
38
39 &lfs91_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&cups-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&cups-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &cups-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &cups-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &cups-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &cups-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Cups Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="gnutls"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="colord"/>,
85 <xref linkend="dbus"/>,
86 <xref linkend="libusb"/>,
87 <xref linkend="linux-pam"/>, and
88 <xref linkend="xdg-utils"/>
89 </para>
90
91 <bridgehead renderas="sect4">Optional</bridgehead>
92 <para role="optional">
93 <xref linkend="avahi"/>,
94 <xref linkend="libpaper"/>,
95 <xref linkend="mitkrb"/>,
96 <xref linkend="openjdk"/>,
97 <xref linkend="php"/>, and
98 <xref linkend="python2"/>
99 </para>
100
101 <bridgehead renderas="sect4">Required (Postinstall)</bridgehead>
102 <para role="required">
103 <xref role="runtime" linkend="cups-filters"/>
104 </para>
105
106 <bridgehead renderas="sect4">Optional (Postinstall)</bridgehead>
107 <para role="optional">
108 <xref role="runtime" linkend="gutenprint"/> and
109 <ulink role="runtime" url="https://developers.hp.com/hp-linux-imaging-and-printing">hplip</ulink> (HP printers)
110 </para>
111
112 <para condition="html" role="usernotes">User Notes:
113 <ulink url="&blfs-wiki;/cups"/>
114 </para>
115 </sect2>
116
117 <sect2 role="kernel" id="cups-kernel">
118 <title>Kernel Configuration</title>
119
120 <note>
121 <para>
122 There used to be a conflict between the <application>Cups</application>
123 <application>libusb</application> backend and the usblp kernel driver.
124 This is no longer the case and cups will work with both of these
125 enabled.
126 </para>
127 </note>
128
129 <para>
130 If you want to use the kernel usblp driver (for example, if you wish to
131 use <application>escputil</application> from <xref
132 linkend="gutenprint"/>) enable the following options in your kernel
133 configuration and recompile the kernel:
134 </para>
135
136<screen><literal>Device Drivers ---&gt;
137 [*] USB support ---&gt; [CONFIG_USB_SUPPORT]
138 &lt;*/M&gt; OHCI HCD (USB 1.1) support [CONFIG_USB_OHCI_HCD]
139 &lt;*/M&gt; UHCI HCD (most Intel and VIA) support [CONFIG_USB_UHCI_HCD]
140 &lt;*/M&gt; USB Printer support [CONFIG_USB_PRINTER]</literal></screen>
141
142 <para>
143 If you have a parallel printer, enable the following options in your
144 kernel configuration and recompile the kernel:
145 </para>
146
147<screen><literal>Device Drivers ---&gt;
148 &lt;*/M&gt; Parallel port support ---&gt; [CONFIG_PARPORT]
149 &lt;*/M&gt; PC-style hardware [CONFIG_PARPORT_PC]
150 Character devices ---&gt;
151 &lt;*/M&gt; Parallel printer support [CONFIG_PRINTER]</literal></screen>
152
153 <indexterm zone="cups cups-kernel">
154 <primary sortas="d-cups">cups</primary>
155 </indexterm>
156
157 </sect2>
158
159 <sect2 role="installation">
160 <title>Installation of Cups</title>
161
162 <para>
163 You will need to add an <systemitem class="username">lp</systemitem>
164 user, as <application>Cups</application> will create some files owned
165 by this user. (The <systemitem class="username">lp</systemitem> user
166 is the default used by <application>Cups</application>, but may be
167 changed to a different user by passing a parameter to the
168 <command>configure</command> script.) Use the following command as
169 the <systemitem class="username">root</systemitem> user:
170 </para>
171
172<screen role="root"><userinput>useradd -c "Print Service User" -d /var/spool/cups -g lp -s /bin/false -u 9 lp</userinput></screen>
173
174 <para>
175 You will also need a dedicated group that will contain users allowed to
176 do <application>Cups</application> administrative tasks. Add the group
177 by running the following command as the
178 <systemitem class="username">root</systemitem> user:
179 </para>
180
181<screen role="root"><userinput>groupadd -g 19 lpadmin</userinput></screen>
182
183 <para>
184 If you want to add a user to the <application>Cups</application>
185 administrative group, run the following command as the
186 <systemitem class="username">root</systemitem> user:
187 </para>
188
189<screen role="root"><userinput>usermod -a -G lpadmin <replaceable>&lt;username&gt;</replaceable></userinput></screen>
190
191 <para>
192 If you didn't install <xref linkend="xdg-utils"/>, use the following
193 <command>sed</command> to change the default browser that will be used
194 to access the <application>Cups</application> web interface:
195 </para>
196
197<screen><userinput>sed -i 's#@CUPS_HTMLVIEW@#firefox#' desktop/cups.desktop.in</userinput></screen>
198
199 <para>
200 Replace <command>firefox</command> with the web browser of your
201 choice.
202 </para>
203
204 <para>
205 Build <application>Cups</application> by running the following commands:
206 </para>
207
208
209<screen revision="sysv"><userinput>sed -i '/stat.h/a #include &lt;asm-generic/ioctls.h&gt;' tools/ipptool.c &amp;&amp;
210
211CC=gcc CXX=g++ \
212./configure --libdir=/usr/lib \
213 --disable-systemd \
214 --with-rcdir=/tmp/cupsinit \
215 --with-system-groups=lpadmin \
216 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
217make</userinput></screen>
218
219<screen revision="systemd"><userinput>sed -i '/stat.h/a #include &lt;asm-generic/ioctls.h&gt;' tools/ipptool.c &amp;&amp;
220
221CC=gcc CXX=g++ \
222./configure --libdir=/usr/lib \
223 --with-rcdir=/tmp/cupsinit \
224 --with-system-groups=lpadmin \
225 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
226make</userinput></screen>
227
228 <para>
229 To test the results, issue: <command>make -k check</command>. An already
230 active graphical session with bus address is necessary to run the tests.
231 One test, <filename>httpAddrGetList</filename>, is known to fail.
232 </para>
233
234 <para>
235 Now, as the <systemitem class="username">root</systemitem> user:
236 </para>
237
238<!-- dev note: make BUILDROOT=<DESTDIR> install -->
239
240<screen role="root"><userinput>make install &amp;&amp;
241rm -rf /tmp/cupsinit &amp;&amp;
242ln -svnf ../cups/doc-&cups-version; /usr/share/doc/cups-&cups-version;</userinput></screen>
243
244 <para>
245 Create a basic <application>Cups</application> client configuration file
246 by running the following command as the <systemitem
247 class="username">root</systemitem> user:
248 </para>
249
250<screen role="root"><userinput>echo "ServerName /run/cups/cups.sock" > /etc/cups/client.conf</userinput></screen>
251
252 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
253 href="../../xincludes/gtk-update-icon-cache.xml"/>
254
255 </sect2>
256
257 <sect2 role="commands">
258 <title>Command Explanations</title>
259
260 <para>
261 <command>sed ... tools/ipptool.c</command>: This sed fixes a bug caused
262 by glibc-2.30 changing the user-space API for sockets.
263 </para>
264
265 <para>
266 <envar>CC=gcc CXX=g++</envar>: This environment variable ensures that gcc is used,
267 if clang is installed. Remove it, if you prefer to use clang. Using clang
268 almost doubles build time and slightly decreases build disk space.
269 Installed disk space is not appreciably modified.
270 </para>
271
272 <para revision="sysv">
273 <parameter>--disable-systemd</parameter>: Systemd is not supported by
274 this version of BLFS.
275 </para>
276
277 <para>
278 <parameter>--with-rcdir=/tmp/cupsinit</parameter>: This switch tells the
279 build process to install the shipped bootscript into <filename
280 class="directory">/tmp</filename> instead of <filename
281 class="directory">/etc/rc.d</filename>.
282 </para>
283
284 <para>
285 <parameter>--with-system-groups=lpadmin</parameter>: This switch ensures
286 that only <systemitem class="groupname">lpadmin</systemitem> will be used
287 as the <application>Cups</application> administrative group.
288 </para>
289
290 <para>
291 <option>--disable-libusb</option>: Use this switch if you have installed
292 <xref linkend="libusb"/>, but wish to use the kernel usblp driver.
293 </para>
294
295 <para>
296 <option>--enable-libpaper</option>: Use this switch if you have installed
297 <application>libpaper</application> and wish to use it with
298 <application>Cups</application>.
299 </para>
300
301 </sect2>
302
303 <sect2 role="configuration">
304 <title>Configuring Cups</title>
305
306 <sect3 id="cups-config">
307 <title>Config Files</title>
308
309 <para>
310 <filename>/etc/cups/*</filename>
311 </para>
312
313 <indexterm zone="cups cups-config">
314 <primary sortas="e-etc-cups">/etc/cups/*</primary>
315 </indexterm>
316
317 </sect3>
318
319 <sect3>
320 <title>Configuration Information</title>
321
322 <para>
323 Normally, printers are set up via a web browser. The
324 <application>Cups</application> server will normally connect via
325 the url http://localhost:631. From there printers, print
326 jobs, and the server configuration can be set up and managed.
327 Remote system administration can also be set up. Configuration
328 can also be done from the command line via the
329 <command>lpadmin</command>, <command>lpoptions</command>,
330 and <command>lpstat</command> commands.
331 </para>
332
333 <para>
334 Configuration of <application>Cups</application> is dependent on
335 the type of printer and can be complex. Generally, PostScript printers
336 are easier. For detailed instructions on configuration and use of
337 <application>Cups</application>, see <ulink
338 url="http://www.cups.org/documentation.php"/>.
339 </para>
340
341 <para>
342 For non-PostScript printers to print with
343 <application>Cups</application>, you need to install <xref
344 linkend="gs"/> to convert PostScript to raster images and a driver
345 (e.g. from <xref linkend="gutenprint"/>) to convert the resulting
346 raster images to a form that the printer understands. <ulink
347 url="https://wiki.linuxfoundation.org/openprinting/database/foomatic">Foomatic</ulink>
348 drivers use <xref linkend="gs"/> to convert PostScript to a printable
349 form directly, but this is considered suboptimal by
350 <application>Cups</application> developers.
351 </para>
352
353 </sect3>
354
355 <sect3>
356 <title>Linux PAM Configuration</title>
357
358 <para>
359 If <application>CUPS</application> has been built with
360 <application>Linux PAM</application> support, you need to create a
361 <application>PAM</application> configuration file to get it working
362 correctly with BLFS.
363 </para>
364
365 <para>
366 Issue the following command as the <systemitem
367 class="username">root</systemitem> user to create the configuration
368 file for <application>Linux PAM</application>:
369 </para>
370
371<screen role="root"><userinput>cat &gt; /etc/pam.d/cups &lt;&lt; "EOF"
372<literal># Begin /etc/pam.d/cups
373
374auth include system-auth
375account include system-account
376session include system-session
377
378# End /etc/pam.d/cups</literal>
379EOF</userinput></screen>
380
381 </sect3>
382
383 <sect3 id="cups-init">
384 <title><phrase revision="sysv">Boot Script</phrase>
385 <phrase revision="systemd">Systemd Unit</phrase></title>
386
387 <para revision="sysv">
388 If you want the <application>Cups</application> print service to start
389 automatically when the system is booted, install the init script
390 included in the <xref linkend="bootscripts"/> package:
391 </para>
392
393 <para revision="systemd">
394 To start the <command>cupsd</command> daemon when something tries to
395 access it, enable the previously installed systemd units by running
396 the following command as the
397 <systemitem class="username">root</systemitem> user:
398 </para>
399
400 <indexterm zone="cups cups-init">
401 <primary sortas="f-cups">cups</primary>
402 </indexterm>
403
404<screen role="root" revision="sysv"><userinput>make install-cups</userinput></screen>
405
406<screen role="root" revision="systemd"><userinput>systemctl enable org.cups.cupsd</userinput></screen>
407
408 </sect3>
409
410 </sect2>
411
412 <sect2 role="content">
413 <title>Contents</title>
414
415 <segmentedlist>
416 <segtitle>Installed Programs</segtitle>
417 <segtitle>Installed Libraries</segtitle>
418 <segtitle>Installed Directories</segtitle>
419
420 <seglistitem>
421 <seg>
422 accept, cancel, cupsaccept, cupsaddsmb, cups-config, cupsctl, cupsd,
423 cupsdisable, cupsenable, cupsfilter, cupsreject, cupstestdsc,
424 cupstestppd, ippfind, ipptool, lp, lpadmin, lpc, lpinfo, lpmove,
425 lpoptions, lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge,
426 ppdpo, and reject
427 </seg>
428 <seg>
429 libcupscgi.so, libcupsimage.so, libcupsmime.so,
430 libcupsppdc.so, and libcups.so
431 </seg>
432 <seg>
433 /etc/cups,
434 /usr/{include,lib,share}/cups,
435 /usr/share/doc/cups-&cups-version;, and
436 /var/{cache,log,run,spool}/cups
437 </seg>
438 </seglistitem>
439 </segmentedlist>
440
441 <variablelist>
442 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
443 <?dbfo list-presentation="list"?>
444 <?dbhtml list-presentation="table"?>
445
446 <varlistentry id="accept">
447 <term><command>accept</command></term>
448 <listitem>
449 <para>
450 instructs the printing system to accept print jobs to the
451 specified destinations.
452 </para>
453 <indexterm zone="cups accept">
454 <primary sortas="b-accept">accept</primary>
455 </indexterm>
456 </listitem>
457 </varlistentry>
458
459 <varlistentry id="cancel-cups">
460 <term><command>cancel</command></term>
461 <listitem>
462 <para>
463 cancels existing print jobs from the print queues.
464 </para>
465 <indexterm zone="cups cancel-cups">
466 <primary sortas="b-cancel">cancel</primary>
467 </indexterm>
468 </listitem>
469 </varlistentry>
470
471 <varlistentry id="cupsaccept">
472 <term><command>cupsaccept</command></term>
473 <listitem>
474 <para>
475 accept jobs sent to a destination.
476 </para>
477 <indexterm zone="cups cupsaccept">
478 <primary sortas="b-cupsaccept">cupsaccept</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 <varlistentry id="cupsaddsmb">
484 <term><command>cupsaddsmb</command></term>
485 <listitem>
486 <para>
487 exports printers to the <application>Samba</application>
488 software for use with Windows clients.
489 </para>
490 <indexterm zone="cups cupsaddsmb">
491 <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="cups-config-prog">
497 <term><command>cups-config</command></term>
498 <listitem>
499 <para>
500 is a <application>Cups</application>
501 program configuration utility.
502 </para>
503 <indexterm zone="cups cups-config-prog">
504 <primary sortas="b-cups-config">cups-config</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="cupsctl">
510 <term><command>cupsctl</command></term>
511 <listitem>
512 <para>
513 updates or queries the cupsd.conf file for a server.
514 </para>
515 <indexterm zone="cups cupsctl">
516 <primary sortas="b-cupsctl">cupsctl</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="cupsd">
522 <term><command>cupsd</command></term>
523 <listitem>
524 <para>
525 is the scheduler for the Common Unix Printing System.
526 </para>
527 <indexterm zone="cups cupsd">
528 <primary sortas="b-cupsd">cupsd</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 <varlistentry id="cupsdisable">
534 <term><command>cupsdisable</command></term>
535 <listitem>
536 <para>
537 stop printers and classes.
538 </para>
539 <indexterm zone="cups cupsdisable">
540 <primary sortas="b-cupsdisable">cupsdisable</primary>
541 </indexterm>
542 </listitem>
543 </varlistentry>
544
545 <varlistentry id="cupsenable">
546 <term><command>cupsenable</command></term>
547 <listitem>
548 <para>
549 start printers and classes.
550 </para>
551 <indexterm zone="cups cupsenable">
552 <primary sortas="b-cupsenable">cupsenable</primary>
553 </indexterm>
554 </listitem>
555 </varlistentry>
556
557 <varlistentry id="cupsfilter">
558 <term><command>cupsfilter</command></term>
559 <listitem>
560 <para>
561 is a front-end to the <application>Cups</application>
562 filter subsystem which allows you to convert a file
563 to a specific format.
564 </para>
565 <indexterm zone="cups cupsfilter">
566 <primary sortas="b-cupsfilter">cupsfilter</primary>
567 </indexterm>
568 </listitem>
569 </varlistentry>
570
571 <varlistentry id="cupsreject">
572 <term><command>cupsreject</command></term>
573 <listitem>
574 <para>
575 reject jobs sent to a destination.
576 </para>
577 <indexterm zone="cups cupsreject">
578 <primary sortas="b-cupsreject">cupsreject</primary>
579 </indexterm>
580 </listitem>
581 </varlistentry>
582
583 <varlistentry id="cupstestdsc">
584 <term><command>cupstestdsc</command></term>
585 <listitem>
586 <para>
587 tests the conformance of PostScript files.
588 </para>
589 <indexterm zone="cups cupstestdsc">
590 <primary sortas="b-cupstestdsc">cupstestdsc</primary>
591 </indexterm>
592 </listitem>
593 </varlistentry>
594
595 <varlistentry id="cupstestppd">
596 <term><command>cupstestppd</command></term>
597 <listitem>
598 <para>
599 tests the conformance of PPD files.
600 </para>
601 <indexterm zone="cups cupstestppd">
602 <primary sortas="b-cupstestppd">cupstestppd</primary>
603 </indexterm>
604 </listitem>
605 </varlistentry>
606
607 <varlistentry id="ippfind">
608 <term><command>ippfind</command></term>
609 <listitem>
610 <para>
611 finds internet printing protocol printers.
612 </para>
613 <indexterm zone="cups ippfind">
614 <primary sortas="b-ippfind">ippfind</primary>
615 </indexterm>
616 </listitem>
617 </varlistentry>
618
619 <varlistentry id="ipptool">
620 <term><command>ipptool</command></term>
621 <listitem>
622 <para>
623 sends IPP requests to the specified URI and tests
624 and/or displays the results.
625 </para>
626 <indexterm zone="cups ipptool">
627 <primary sortas="b-ipptool">ipptool</primary>
628 </indexterm>
629 </listitem>
630 </varlistentry>
631
632 <varlistentry id="lp-cups">
633 <term><command>lp</command></term>
634 <listitem>
635 <para>
636 submits files for printing or alters a pending job.
637 </para>
638 <indexterm zone="cups lp-cups">
639 <primary sortas="b-lp">lp</primary>
640 </indexterm>
641 </listitem>
642 </varlistentry>
643
644 <varlistentry id="lpadmin">
645 <term><command>lpadmin</command></term>
646 <listitem>
647 <para>
648 configures printer and class queues provided by
649 <application>Cups</application>.
650 </para>
651 <indexterm zone="cups lpadmin">
652 <primary sortas="b-lpadmin">lpadmin</primary>
653 </indexterm>
654 </listitem>
655 </varlistentry>
656
657 <varlistentry id="lpc-cups">
658 <term><command>lpc</command></term>
659 <listitem>
660 <para>
661 provides limited control over printer and class queues
662 provided by <application>Cups</application>.
663 </para>
664 <indexterm zone="cups lpc-cups">
665 <primary sortas="b-lpc">lpc</primary>
666 </indexterm>
667 </listitem>
668 </varlistentry>
669
670 <varlistentry id="lpinfo">
671 <term><command>lpinfo</command></term>
672 <listitem>
673 <para>
674 lists the available devices or drivers known to the
675 <application>Cups</application> server.
676 </para>
677 <indexterm zone="cups lpinfo">
678 <primary sortas="b-lpinfo">lpinfo</primary>
679 </indexterm>
680 </listitem>
681 </varlistentry>
682
683 <varlistentry id="lpmove">
684 <term><command>lpmove</command></term>
685 <listitem>
686 <para>
687 moves the specified job to a new destination.
688 </para>
689 <indexterm zone="cups lpmove">
690 <primary sortas="b-lpmove">lpmove</primary>
691 </indexterm>
692 </listitem>
693 </varlistentry>
694
695 <varlistentry id="lpoptions">
696 <term><command>lpoptions</command></term>
697 <listitem>
698 <para>
699 displays or sets printer options and defaults.
700 </para>
701 <indexterm zone="cups lpoptions">
702 <primary sortas="b-lpoptions">lpoptions</primary>
703 </indexterm>
704 </listitem>
705 </varlistentry>
706
707 <varlistentry id="lpq-cups">
708 <term><command>lpq</command></term>
709 <listitem>
710 <para>
711 shows the current print queue status on the named printer.
712 </para>
713 <indexterm zone="cups lpq-cups">
714 <primary sortas="b-lpq">lpq</primary>
715 </indexterm>
716 </listitem>
717 </varlistentry>
718
719 <varlistentry id="lpr-cups">
720 <term><command>lpr</command></term>
721 <listitem>
722 <para>
723 submits files for printing.
724 </para>
725 <indexterm zone="cups lpr-cups">
726 <primary sortas="b-lpr">lpr</primary>
727 </indexterm>
728 </listitem>
729 </varlistentry>
730
731 <varlistentry id="lprm-cups">
732 <term><command>lprm</command></term>
733 <listitem>
734 <para>
735 cancels print jobs that have been queued for printing.
736 </para>
737 <indexterm zone="cups lprm-cups">
738 <primary sortas="b-lprm">lprm</primary>
739 </indexterm>
740 </listitem>
741 </varlistentry>
742
743 <varlistentry id="lpstat-cups">
744 <term><command>lpstat</command></term>
745 <listitem>
746 <para>
747 displays status information about the current classes, jobs,
748 and printers.
749 </para>
750 <indexterm zone="cups lpstat-cups">
751 <primary sortas="b-lpstat">lpstat</primary>
752 </indexterm>
753 </listitem>
754 </varlistentry>
755
756 <varlistentry id="ppdc">
757 <term><command>ppdc</command></term>
758 <listitem>
759 <para>
760 compiles PPDC source files into one or more PPD files.
761 </para>
762 <indexterm zone="cups ppdc">
763 <primary sortas="b-ppdc">ppdc</primary>
764 </indexterm>
765 </listitem>
766 </varlistentry>
767
768 <varlistentry id="ppdhtml">
769 <term><command>ppdhtml</command></term>
770 <listitem>
771 <para>
772 reads a driver information file and produces a HTML summary
773 page that lists all of the drivers in a file and the
774 supported options.
775 </para>
776 <indexterm zone="cups ppdhtml">
777 <primary sortas="b-ppdhtml">ppdhtml</primary>
778 </indexterm>
779 </listitem>
780 </varlistentry>
781
782 <varlistentry id="ppdi">
783 <term><command>ppdi</command></term>
784 <listitem>
785 <para>
786 imports one or more PPD files into a PPD compiler source file.
787 </para>
788 <indexterm zone="cups ppdi">
789 <primary sortas="b-ppdi">ppdi</primary>
790 </indexterm>
791 </listitem>
792 </varlistentry>
793
794 <varlistentry id="ppdmerge">
795 <term><command>ppdmerge</command></term>
796 <listitem>
797 <para>
798 merges two or more PPD files into a single, multi-language
799 PPD file.
800 </para>
801 <indexterm zone="cups ppdmerge">
802 <primary sortas="b-ppdmerge">ppdmerge</primary>
803 </indexterm>
804 </listitem>
805 </varlistentry>
806
807 <varlistentry id="ppdpo">
808 <term><command>ppdpo</command></term>
809 <listitem>
810 <para>
811 extracts UI strings from PPDC source files and
812 updates either a GNU gettext or Mac OS X strings
813 format message catalog source file for translation.
814 </para>
815 <indexterm zone="cups ppdpo">
816 <primary sortas="b-ppdpo">ppdpo</primary>
817 </indexterm>
818 </listitem>
819 </varlistentry>
820
821 <varlistentry id="reject">
822 <term><command>reject</command></term>
823 <listitem>
824 <para>
825 instructs the printing system to reject print jobs to the
826 specified destinations.
827 </para>
828 <indexterm zone="cups reject">
829 <primary sortas="b-reject">reject</primary>
830 </indexterm>
831 </listitem>
832 </varlistentry>
833
834 <varlistentry id="libcups">
835 <term><filename class="libraryfile">libcups.so</filename></term>
836 <listitem>
837 <para>
838 contains the <application>Cups</application> API functions.
839 </para>
840 <indexterm zone="cups libcups">
841 <primary sortas="c-libcups">libcups.so</primary>
842 </indexterm>
843 </listitem>
844 </varlistentry>
845
846 </variablelist>
847
848 </sect2>
849
850</sect1>
Note: See TracBrowser for help on using the repository browser.