source: pst/printing/cups.xml@ c870dc3

10.0 10.1 11.0 11.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c870dc3 was c870dc3, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • Update to adwaita-icon-theme-3.18.0.
  • Update to gtk+-3.18.2.
  • Update to pango-1.38.1.
  • Cups-2.1.0: no problem building without AVAHI.
  • PulseAudio-7.0: typo.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16551 af4574ff-66df-0310-9fd7-8a98e5e911e0

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