source: pst/printing/cups.xml@ 63a0217

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 63a0217 was a953e682, checked in by Douglas R. Reno <renodr@…>, 12 months ago

CUPS: Update to work with systemd

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