source: pst/printing/cups.xml@ f50f3f3

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f50f3f3 was f50f3f3, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to ffmpeg-4.1.2.
Update to cups-2.2.11.
Update to Net-DNS-1.20 (Perl Module).

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

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