source: pst/printing/cups.xml@ 3d16a42

trunk
Last change on this file since 3d16a42 was 3d16a42, checked in by Thomas Trepl (Moody) <thomas@…>, 3 months ago

Use OpenPrinting CUPS

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