source: pst/printing/cups.xml@ a1a7d7f

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

Update to unbound-1.9.3.
Update to cbindgen-0.9.1.
Update to cups-2.3.0.

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