source: pst/printing/cups.xml

trunk
Last change on this file was 35f4faf, checked in by Xi Ruoyao <xry111@…>, 3 weeks ago

cups: remove reference to clang

Now configure script prefers GCC.

  • Property mode set to 100644
File size: 28.3 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/OpenPrinting/cups/releases/download/v&cups-version;/cups-&cups-version;-source.tar.gz">
8 <!ENTITY cups-download-ftp " ">
9 <!ENTITY cups-md5sum "be5241e2c165eeb83b58aa32de26fb16">
10 <!ENTITY cups-size "7.8 MB">
11 <!ENTITY cups-buildsize "60 MB (Add 37 MB for tests)">
12 <!ENTITY cups-time "0.5 SBU (Add 1.3 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 &lfs112_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"/>, Not found in 2.4.0 -->
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<!-- Fixed in 2.4.1
204 <para revision="systemd">
205 Fix a bug that causes the <filename>cups.service</filename> systemd unit
206 to be placed into a non-existent target:
207 </para>
208
209<screen revision="systemd"><userinput remap="pre">sed -e "s/printers.target/printer.target/" \
210 -i configure \
211 config-scripts/cups-defaults.m4</userinput></screen>
212-->
213
214 <para>
215 Build <application>Cups</application> by running the following commands:
216 </para>
217
218<screen revision="sysv"><userinput>./configure --libdir=/usr/lib \
219 --disable-systemd \
220 --with-rcdir=/tmp/cupsinit \
221 --with-system-groups=lpadmin \
222 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
223make</userinput></screen>
224
225<screen revision="systemd"><userinput>./configure --libdir=/usr/lib \
226 --with-system-groups=lpadmin \
227 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
228make</userinput></screen>
229
230 <para>
231 To test the results, issue: <command>LC_ALL=C make -k check</command>. An already
232 active graphical session with bus address is necessary to run the tests.
233 Make sure that there is not other instance of <application>Cups</application>
234 running, otherwise at least 4 tests will fail with "address in use".
235 One test, <filename>httpAddrGetList</filename>, is known to fail.
236 </para>
237
238 <para>
239 Now, as the <systemitem class="username">root</systemitem> user:
240 </para>
241
242<!-- dev note: make BUILDROOT=<DESTDIR> install -->
243
244<screen role="root"><userinput>make install &amp;&amp;
245ln -svnf ../cups/doc-&cups-version; /usr/share/doc/cups-&cups-version;</userinput></screen>
246
247 <para revision="sysv">
248 Remove the shipped bootscript, which is incompatible with LFS:
249 </para>
250
251<screen role="root" revision="sysv"><userinput>rm -rf /tmp/cupsinit &amp;&amp;</userinput></screen>
252
253 <para>
254 Create a basic <application>Cups</application> client configuration file
255 by running the following command as the <systemitem
256 class="username">root</systemitem> user:
257 </para>
258
259<screen role="root"><userinput>echo "ServerName /run/cups/cups.sock" > /etc/cups/client.conf</userinput></screen>
260
261 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
262 href="../../xincludes/gtk-update-icon-cache.xml"/>
263
264 </sect2>
265
266 <sect2 role="commands">
267 <title>Command Explanations</title>
268
269 <para>
270 <command>sed ... configure</command>: This sed removes a compiler
271 option which is no longer supported. Leaving this change out, the
272 compilation will run thru but a warning about an invalid
273 warning option will be emitted on every compiler invocation.
274 </para>
275<!--
276 <para>
277 <command>sed ... tools/ipptool.c</command>: This sed fixes a bug caused
278 by glibc-2.30 changing the user-space API for sockets.
279 </para>
280-->
281 <para>
282 <envar>CC=gcc CXX=g++</envar>: Setting them if you prefer to use
283 <command>gcc</command> instead of <command>clang</command>, which is
284 now preferred by the upstream.
285 </para>
286
287 <para revision="sysv">
288 <parameter>--disable-systemd</parameter>: Systemd is not supported by
289 this version of BLFS.
290 </para>
291
292 <para revision="sysv">
293 <parameter>--with-rcdir=/tmp/cupsinit</parameter>: This switch tells the
294 build process to install the shipped bootscript into <filename
295 class="directory">/tmp</filename> instead of <filename
296 class="directory">/etc/rc.d</filename>.
297 </para>
298
299 <para>
300 <parameter>--with-system-groups=lpadmin</parameter>: This switch ensures
301 that only <systemitem class="groupname">lpadmin</systemitem> will be used
302 as the <application>Cups</application> administrative group.
303 </para>
304
305 <para>
306 <option>--disable-libusb</option>: Use this switch if you have installed
307 <xref linkend="libusb"/>, but wish to use the kernel usblp driver.
308 </para>
309
310 <para>
311 <option>--enable-libpaper</option>: Use this switch if you have installed
312 <application>libpaper</application> and wish to use it with
313 <application>Cups</application>.
314 </para>
315
316 </sect2>
317
318 <sect2 role="configuration">
319 <title>Configuring Cups</title>
320
321 <sect3 id="cups-config">
322 <title>Config Files</title>
323
324 <para>
325 <filename>/etc/cups/*</filename>
326 </para>
327
328 <indexterm zone="cups cups-config">
329 <primary sortas="e-etc-cups">/etc/cups/*</primary>
330 </indexterm>
331
332 </sect3>
333
334 <sect3>
335 <title>Configuration Information</title>
336
337 <para>
338 Normally, printers are set up via a web browser. The
339 <application>Cups</application> server will normally connect via
340 the url http://localhost:631. From there printers, print
341 jobs, and the server configuration can be set up and managed.
342 Remote system administration can also be set up. Configuration
343 can also be done from the command line via the
344 <command>lpadmin</command>, <command>lpoptions</command>,
345 and <command>lpstat</command> commands.
346 </para>
347
348 <para>
349 Configuration of <application>Cups</application> is dependent on
350 the type of printer and can be complex. Generally, PostScript printers
351 are easier. For detailed instructions on configuration and use of
352 <application>Cups</application>, see <ulink
353 url="http://www.cups.org/documentation.php"/>.
354 </para>
355
356 <para>
357 For non-PostScript printers to print with
358 <application>Cups</application>, you need to install <xref
359 linkend="gs"/> to convert PostScript to raster images and a driver
360 (e.g. from <xref linkend="gutenprint"/>) to convert the resulting
361 raster images to a form that the printer understands. <ulink
362 url="https://wiki.linuxfoundation.org/openprinting/database/foomatic">Foomatic</ulink>
363 drivers use <xref linkend="gs"/> to convert PostScript to a printable
364 form directly, but this is considered suboptimal by
365 <application>Cups</application> developers.
366 </para>
367
368 </sect3>
369
370 <sect3>
371 <title>Linux PAM Configuration</title>
372
373 <para>
374 If <application>CUPS</application> has been built with
375 <application>Linux PAM</application> support, you need to create a
376 <application>PAM</application> configuration file to get it working
377 correctly with BLFS.
378 </para>
379
380 <para>
381 Issue the following command as the <systemitem
382 class="username">root</systemitem> user to create the configuration
383 file for <application>Linux PAM</application>:
384 </para>
385
386<screen role="root"><userinput>cat &gt; /etc/pam.d/cups &lt;&lt; "EOF"
387<literal># Begin /etc/pam.d/cups
388
389auth include system-auth
390account include system-account
391session include system-session
392
393# End /etc/pam.d/cups</literal>
394EOF</userinput></screen>
395
396 </sect3>
397
398 <sect3 id="cups-init">
399 <title><phrase revision="sysv">Boot Script</phrase>
400 <phrase revision="systemd">Systemd Unit</phrase></title>
401
402 <para revision="sysv">
403 If you want the <application>Cups</application> print service to start
404 automatically when the system is booted, install the init script
405 included in the <xref linkend="bootscripts"/> package:
406 </para>
407
408 <para revision="systemd">
409 To start the <command>cupsd</command> daemon when something tries to
410 access it, enable the previously installed systemd units by running
411 the following command as the
412 <systemitem class="username">root</systemitem> user:
413 </para>
414
415 <indexterm zone="cups cups-init">
416 <primary sortas="f-cups">cups</primary>
417 </indexterm>
418
419<screen role="root" revision="sysv"><userinput>make install-cups</userinput></screen>
420
421<screen role="root" revision="systemd"><userinput>systemctl enable cups</userinput></screen>
422
423 </sect3>
424
425 </sect2>
426
427 <sect2 role="content">
428 <title>Contents</title>
429
430 <segmentedlist>
431 <segtitle>Installed Programs</segtitle>
432 <segtitle>Installed Libraries</segtitle>
433 <segtitle>Installed Directories</segtitle>
434
435 <seglistitem>
436 <seg>
437 <!--accept,--> cancel, cupsaccept, <!--cupsaddsmb,--> cups-config,
438 cupsctl, cupsd, cupsdisable, cupsenable, cupsfilter, cupsreject,
439 <!--cupstestdsc,--> cupstestppd, ippeveprinter,<!-- ippfind--> ipptool, lp,
440 lpadmin, lpc, lpinfo, lpmove, lpoptions, lpq, lpr, lprm, lpstat, ppdc,
441 ppdhtml, ppdi, ppdmerge, and ppdpo <!--and reject-->
442 </seg>
443 <seg>
444 <!--libcupscgi.so,--> libcupsimage.so <!--libcupsmime.so,-->
445 <!--libcupsppdc.so,--> and libcups.so
446 </seg>
447 <seg>
448 /etc/cups,
449 /usr/{include,lib,share}/cups,
450 /usr/share/doc/cups-&cups-version;, and
451 /var/{cache,log,run,spool}/cups
452 </seg>
453 </seglistitem>
454 </segmentedlist>
455
456 <variablelist>
457 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
458 <?dbfo list-presentation="list"?>
459 <?dbhtml list-presentation="table"?>
460
461 <!--
462 <varlistentry id="accept">
463 <term><command>accept</command></term>
464 <listitem>
465 <para>
466 instructs the printing system to accept print jobs to the
467 specified destinations.
468 </para>
469 <indexterm zone="cups accept">
470 <primary sortas="b-accept">accept</primary>
471 </indexterm>
472 </listitem>
473 </varlistentry>
474 -->
475
476 <varlistentry id="cancel-cups">
477 <term><command>cancel</command></term>
478 <listitem>
479 <para>
480 cancels existing print jobs from the print queues
481 </para>
482 <indexterm zone="cups cancel-cups">
483 <primary sortas="b-cancel">cancel</primary>
484 </indexterm>
485 </listitem>
486 </varlistentry>
487
488 <varlistentry id="cupsaccept">
489 <term><command>cupsaccept</command></term>
490 <listitem>
491 <para>
492 accept jobs sent to a destination
493 </para>
494 <indexterm zone="cups cupsaccept">
495 <primary sortas="b-cupsaccept">cupsaccept</primary>
496 </indexterm>
497 </listitem>
498 </varlistentry>
499
500<!--
501 <varlistentry id="cupsaddsmb">
502 <term><command>cupsaddsmb</command></term>
503 <listitem>
504 <para>
505 exports printers to the <application>Samba</application>
506 software for use with Windows clients.
507 </para>
508 <indexterm zone="cups cupsaddsmb">
509 <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
510 </indexterm>
511 </listitem>
512 </varlistentry>
513-->
514
515 <varlistentry id="cups-config-prog">
516 <term><command>cups-config</command></term>
517 <listitem>
518 <para>
519 is a <application>Cups</application>
520 program configuration utility
521 </para>
522 <indexterm zone="cups cups-config-prog">
523 <primary sortas="b-cups-config">cups-config</primary>
524 </indexterm>
525 </listitem>
526 </varlistentry>
527
528 <varlistentry id="cupsctl">
529 <term><command>cupsctl</command></term>
530 <listitem>
531 <para>
532 updates or queries the cupsd.conf file for a server
533 </para>
534 <indexterm zone="cups cupsctl">
535 <primary sortas="b-cupsctl">cupsctl</primary>
536 </indexterm>
537 </listitem>
538 </varlistentry>
539
540 <varlistentry id="cupsd">
541 <term><command>cupsd</command></term>
542 <listitem>
543 <para>
544 is the scheduler for the Common Unix Printing System
545 </para>
546 <indexterm zone="cups cupsd">
547 <primary sortas="b-cupsd">cupsd</primary>
548 </indexterm>
549 </listitem>
550 </varlistentry>
551
552 <varlistentry id="cupsdisable">
553 <term><command>cupsdisable</command></term>
554 <listitem>
555 <para>
556 stop printers and classes
557 </para>
558 <indexterm zone="cups cupsdisable">
559 <primary sortas="b-cupsdisable">cupsdisable</primary>
560 </indexterm>
561 </listitem>
562 </varlistentry>
563
564 <varlistentry id="cupsenable">
565 <term><command>cupsenable</command></term>
566 <listitem>
567 <para>
568 start printers and classes
569 </para>
570 <indexterm zone="cups cupsenable">
571 <primary sortas="b-cupsenable">cupsenable</primary>
572 </indexterm>
573 </listitem>
574 </varlistentry>
575
576 <varlistentry id="cupsfilter">
577 <term><command>cupsfilter</command></term>
578 <listitem>
579 <para>
580 is a front-end to the <application>Cups</application>
581 filter subsystem which allows you to convert a file
582 to a specific format
583 </para>
584 <indexterm zone="cups cupsfilter">
585 <primary sortas="b-cupsfilter">cupsfilter</primary>
586 </indexterm>
587 </listitem>
588 </varlistentry>
589
590 <varlistentry id="cupsreject">
591 <term><command>cupsreject</command></term>
592 <listitem>
593 <para>
594 reject jobs sent to a destination
595 </para>
596 <indexterm zone="cups cupsreject">
597 <primary sortas="b-cupsreject">cupsreject</primary>
598 </indexterm>
599 </listitem>
600 </varlistentry>
601<!--
602 <varlistentry id="cupstestdsc">
603 <term><command>cupstestdsc</command></term>
604 <listitem>
605 <para>
606 tests the conformance of PostScript files.
607 </para>
608 <indexterm zone="cups cupstestdsc">
609 <primary sortas="b-cupstestdsc">cupstestdsc</primary>
610 </indexterm>
611 </listitem>
612 </varlistentry>
613-->
614
615 <varlistentry id="cupstestppd">
616 <term><command>cupstestppd</command></term>
617 <listitem>
618 <para>
619 tests the conformance of PPD files
620 </para>
621 <indexterm zone="cups cupstestppd">
622 <primary sortas="b-cupstestppd">cupstestppd</primary>
623 </indexterm>
624 </listitem>
625 </varlistentry>
626
627 <varlistentry id="ippeveprinter">
628 <term><command>ippeveprinter</command></term>
629 <listitem>
630 <para>
631 is an IPP Everywhere printer for CUPS
632 </para>
633 <indexterm zone="cups ippeveprinter">
634 <primary sortas="b-ippeveprinter">ippeveprinter</primary>
635 </indexterm>
636 </listitem>
637 </varlistentry>
638<!--
639 <varlistentry id="ippfind">
640 <term><command>ippfind</command></term>
641 <listitem>
642 <para>
643 finds internet printing protocol printers
644 </para>
645 <indexterm zone="cups ippfind">
646 <primary sortas="b-ippfind">ippfind</primary>
647 </indexterm>
648 </listitem>
649 </varlistentry>
650-->
651 <varlistentry id="ipptool">
652 <term><command>ipptool</command></term>
653 <listitem>
654 <para>
655 sends IPP requests to the specified URI and tests
656 and/or displays the results
657 </para>
658 <indexterm zone="cups ipptool">
659 <primary sortas="b-ipptool">ipptool</primary>
660 </indexterm>
661 </listitem>
662 </varlistentry>
663
664 <varlistentry id="lp-cups">
665 <term><command>lp</command></term>
666 <listitem>
667 <para>
668 submits files for printing or alters a pending job
669 </para>
670 <indexterm zone="cups lp-cups">
671 <primary sortas="b-lp">lp</primary>
672 </indexterm>
673 </listitem>
674 </varlistentry>
675
676 <varlistentry id="lpadmin">
677 <term><command>lpadmin</command></term>
678 <listitem>
679 <para>
680 configures printer and class queues provided by
681 <application>Cups</application>
682 </para>
683 <indexterm zone="cups lpadmin">
684 <primary sortas="b-lpadmin">lpadmin</primary>
685 </indexterm>
686 </listitem>
687 </varlistentry>
688
689 <varlistentry id="lpc-cups">
690 <term><command>lpc</command></term>
691 <listitem>
692 <para>
693 provides limited control over printer and class queues
694 provided by <application>Cups</application>
695 </para>
696 <indexterm zone="cups lpc-cups">
697 <primary sortas="b-lpc">lpc</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
702 <varlistentry id="lpinfo">
703 <term><command>lpinfo</command></term>
704 <listitem>
705 <para>
706 lists the available devices or drivers known to the
707 <application>Cups</application> server
708 </para>
709 <indexterm zone="cups lpinfo">
710 <primary sortas="b-lpinfo">lpinfo</primary>
711 </indexterm>
712 </listitem>
713 </varlistentry>
714
715 <varlistentry id="lpmove">
716 <term><command>lpmove</command></term>
717 <listitem>
718 <para>
719 moves the specified job to a new destination
720 </para>
721 <indexterm zone="cups lpmove">
722 <primary sortas="b-lpmove">lpmove</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
727 <varlistentry id="lpoptions">
728 <term><command>lpoptions</command></term>
729 <listitem>
730 <para>
731 displays or sets printer options and defaults
732 </para>
733 <indexterm zone="cups lpoptions">
734 <primary sortas="b-lpoptions">lpoptions</primary>
735 </indexterm>
736 </listitem>
737 </varlistentry>
738
739 <varlistentry id="lpq-cups">
740 <term><command>lpq</command></term>
741 <listitem>
742 <para>
743 shows the current print queue status on the named printer
744 </para>
745 <indexterm zone="cups lpq-cups">
746 <primary sortas="b-lpq">lpq</primary>
747 </indexterm>
748 </listitem>
749 </varlistentry>
750
751 <varlistentry id="lpr-cups">
752 <term><command>lpr</command></term>
753 <listitem>
754 <para>
755 submits files for printing
756 </para>
757 <indexterm zone="cups lpr-cups">
758 <primary sortas="b-lpr">lpr</primary>
759 </indexterm>
760 </listitem>
761 </varlistentry>
762
763 <varlistentry id="lprm-cups">
764 <term><command>lprm</command></term>
765 <listitem>
766 <para>
767 cancels print jobs that have been queued for printing
768 </para>
769 <indexterm zone="cups lprm-cups">
770 <primary sortas="b-lprm">lprm</primary>
771 </indexterm>
772 </listitem>
773 </varlistentry>
774
775 <varlistentry id="lpstat-cups">
776 <term><command>lpstat</command></term>
777 <listitem>
778 <para>
779 displays status information about the current classes, jobs,
780 and printers
781 </para>
782 <indexterm zone="cups lpstat-cups">
783 <primary sortas="b-lpstat">lpstat</primary>
784 </indexterm>
785 </listitem>
786 </varlistentry>
787
788 <varlistentry id="ppdc">
789 <term><command>ppdc</command></term>
790 <listitem>
791 <para>
792 compiles PPDC source files into one or more PPD files
793 </para>
794 <indexterm zone="cups ppdc">
795 <primary sortas="b-ppdc">ppdc</primary>
796 </indexterm>
797 </listitem>
798 </varlistentry>
799
800 <varlistentry id="ppdhtml">
801 <term><command>ppdhtml</command></term>
802 <listitem>
803 <para>
804 reads a driver information file and produces a HTML summary
805 page that lists all of the drivers in a file and the
806 supported options
807 </para>
808 <indexterm zone="cups ppdhtml">
809 <primary sortas="b-ppdhtml">ppdhtml</primary>
810 </indexterm>
811 </listitem>
812 </varlistentry>
813
814 <varlistentry id="ppdi">
815 <term><command>ppdi</command></term>
816 <listitem>
817 <para>
818 imports one or more PPD files into a PPD compiler source file
819 </para>
820 <indexterm zone="cups ppdi">
821 <primary sortas="b-ppdi">ppdi</primary>
822 </indexterm>
823 </listitem>
824 </varlistentry>
825
826 <varlistentry id="ppdmerge">
827 <term><command>ppdmerge</command></term>
828 <listitem>
829 <para>
830 merges two or more PPD files into a single, multi-language
831 PPD file
832 </para>
833 <indexterm zone="cups ppdmerge">
834 <primary sortas="b-ppdmerge">ppdmerge</primary>
835 </indexterm>
836 </listitem>
837 </varlistentry>
838
839 <varlistentry id="ppdpo">
840 <term><command>ppdpo</command></term>
841 <listitem>
842 <para>
843 extracts UI strings from PPDC source files and
844 updates either a GNU gettext or Mac OS X strings
845 format message catalog source file for translation
846 </para>
847 <indexterm zone="cups ppdpo">
848 <primary sortas="b-ppdpo">ppdpo</primary>
849 </indexterm>
850 </listitem>
851 </varlistentry>
852<!--
853 <varlistentry id="reject">
854 <term><command>reject</command></term>
855 <listitem>
856 <para>
857 instructs the printing system to reject print jobs to the
858 specified destinations.
859 </para>
860 <indexterm zone="cups reject">
861 <primary sortas="b-reject">reject</primary>
862 </indexterm>
863 </listitem>
864 </varlistentry>
865-->
866 <varlistentry id="libcups">
867 <term><filename class="libraryfile">libcups.so</filename></term>
868 <listitem>
869 <para>
870 contains the <application>Cups</application> API functions
871 </para>
872 <indexterm zone="cups libcups">
873 <primary sortas="c-libcups">libcups.so</primary>
874 </indexterm>
875 </listitem>
876 </varlistentry>
877
878 </variablelist>
879
880 </sect2>
881
882</sect1>
Note: See TracBrowser for help on using the repository browser.