source: pst/printing/cups.xml@ 38489aa0

10.0 10.1 11.0 8.4 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 38489aa0 was 38489aa0, checked in by Pierre Labastie <pieere@…>, 3 years ago

Tags

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