source: pst/printing/cups.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 4 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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