source: pst/printing/cups.xml@ 3c7bd00

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules 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 3c7bd00 was 3c7bd00, checked in by DJ Lucas <dj@…>, 8 years ago

Temporary render fix for bootscripts with REV=systemd.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17430 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 27.5 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 "62b8fafd590e75f72316915790b0850a">
10 <!ENTITY cups-size "8.5 MB">
11 <!ENTITY cups-buildsize "72 MB (116 MB with tests)">
12 <!ENTITY cups-time "0.5 SBU (5.6 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 &lfs79_checked;&gcc6_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
225CC=gcc \
226./configure --libdir=/usr/lib \
227 --disable-systemd \
228 --with-rcdir=/tmp/cupsinit \
229 --with-system-groups=lpadmin \
230 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
231make</userinput></screen>
232
233 <para>
234 To test the results, issue: <command>make -k check</command>. An already
235 active graphical session with bus address is necessary to run the tests.
236 Some tests fail for unknown reasons.
237 </para>
238
239 <para>
240 Now, as the <systemitem class="username">root</systemitem> user:
241 </para>
242
243<!-- dev note: make BUILDROOT=<DESTDIR> install -->
244
245<screen role="root"><userinput>make install &amp;&amp;
246rm -rf /tmp/cupsinit &amp;&amp;
247ln -svnf ../cups/doc-&cups-version; /usr/share/doc/cups-&cups-version;</userinput></screen>
248
249 <para>
250 Create a basic <application>Cups</application> client configuration file
251 by running the following command as the <systemitem
252 class="username">root</systemitem> user:
253 </para>
254
255<screen role="root"><userinput>echo "ServerName /var/run/cups/cups.sock" > /etc/cups/client.conf</userinput></screen>
256
257 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
258 href="../../xincludes/gtk-update-icon-cache.xml"/>
259
260 </sect2>
261
262 <sect2 role="commands">
263 <title>Command Explanations</title>
264
265 <para>
266 <command>sed ... Makedefs.in</command>: Fix files and directories
267 permissions.
268 </para>
269
270 <para>
271 <command>sed ... cups-manpages.m4</command>: This sed prevents
272 compression of the man pages by default.
273 </para>
274
275 <para>
276 <command>sed ... cups-ssl.m4</command>: Prevent
277 <command>configure</command> script from searching
278 <command>libgcrypt-config</command>, because
279 <application>libgcrypt</application> is not used anywere else in the
280 package.
281 </para>
282
283 <para>
284 <envar>CC=gcc</envar>: This environment variable ensures that gcc is used,
285 if clang is installed. Remove it, if you prefer to use clang. Using clang
286 almost doubles build time and slightly decreases build disk space.
287 Installed disk space is not appreciably modified.
288 </para>
289<!--
290 <para>
291 <command>sed ... test/ippserver.c</command>: This sed fixes a bug,
292 which shows up when <application>avahi</application> is not present.
293 </para>-->
294
295 <para>
296 <parameter>--disable-systemd</parameter>: Systemd is not supported by
297 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>Boot Script</title>
406
407 <para>
408 If you want the <application>Cups</application> print service to start
409 automatically when the system is booted, install the init
410 script included in the <xref linkend="bootscripts" revision="sysv"/>
411 <xref linkend="systemd-units" revision="systemd"/>
412 package:
413 </para>
414
415 <indexterm zone="cups cups-init">
416 <primary sortas="f-cups">cups</primary>
417 </indexterm>
418
419<screen role="root"><userinput>make install-cups</userinput></screen>
420
421 </sect3>
422
423 </sect2>
424
425 <sect2 role="content">
426 <title>Contents</title>
427
428 <segmentedlist>
429 <segtitle>Installed Programs</segtitle>
430 <segtitle>Installed Libraries</segtitle>
431 <segtitle>Installed Directories</segtitle>
432
433 <seglistitem>
434 <seg>
435 accept, cancel, cupsaccept, cupsaddsmb, cups-config, cupsctl, cupsd,
436 cupsdisable, cupsenable, cupsfilter, cupsreject, cupstestdsc,
437 cupstestppd, ippfind, ipptool, lp, lpadmin, lpc, lpinfo, lpmove,
438 lpoptions, lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge,
439 ppdpo, and reject
440 </seg>
441 <seg>
442 libcupscgi.so, libcupsimage.so, libcupsmime.so,
443 libcupsppdc.so, and libcups.so
444 </seg>
445 <seg>
446 /etc/cups,
447 /usr/{include,lib,share}/cups,
448 /usr/share/doc/cups-&cups-version;, and
449 /var/{cache,log,run,spool}/cups
450 </seg>
451 </seglistitem>
452 </segmentedlist>
453
454 <variablelist>
455 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
456 <?dbfo list-presentation="list"?>
457 <?dbhtml list-presentation="table"?>
458
459 <varlistentry id="accept">
460 <term><command>accept</command></term>
461 <listitem>
462 <para>
463 instructs the printing system to accept print jobs to the
464 specified destinations.
465 </para>
466 <indexterm zone="cups accept">
467 <primary sortas="b-accept">accept</primary>
468 </indexterm>
469 </listitem>
470 </varlistentry>
471
472 <varlistentry id="cancel-cups">
473 <term><command>cancel</command></term>
474 <listitem>
475 <para>
476 cancels existing print jobs from the print queues.
477 </para>
478 <indexterm zone="cups cancel-cups">
479 <primary sortas="b-cancel">cancel</primary>
480 </indexterm>
481 </listitem>
482 </varlistentry>
483
484 <varlistentry id="cupsaccept">
485 <term><command>cupsaccept</command></term>
486 <listitem>
487 <para>
488 accept jobs sent to a destination.
489 </para>
490 <indexterm zone="cups cupsaccept">
491 <primary sortas="b-cupsaccept">cupsaccept</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="cupsaddsmb">
497 <term><command>cupsaddsmb</command></term>
498 <listitem>
499 <para>
500 exports printers to the <application>Samba</application>
501 software for use with Windows clients.
502 </para>
503 <indexterm zone="cups cupsaddsmb">
504 <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
505 </indexterm>
506 </listitem>
507 </varlistentry>
508
509 <varlistentry id="cups-config-prog">
510 <term><command>cups-config</command></term>
511 <listitem>
512 <para>
513 is a <application>Cups</application>
514 program configuration utility.
515 </para>
516 <indexterm zone="cups cups-config-prog">
517 <primary sortas="b-cups-config">cups-config</primary>
518 </indexterm>
519 </listitem>
520 </varlistentry>
521
522 <varlistentry id="cupsctl">
523 <term><command>cupsctl</command></term>
524 <listitem>
525 <para>
526 updates or queries the cupsd.conf file for a server.
527 </para>
528 <indexterm zone="cups cupsctl">
529 <primary sortas="b-cupsctl">cupsctl</primary>
530 </indexterm>
531 </listitem>
532 </varlistentry>
533
534 <varlistentry id="cupsd">
535 <term><command>cupsd</command></term>
536 <listitem>
537 <para>
538 is the scheduler for the Common Unix Printing System.
539 </para>
540 <indexterm zone="cups cupsd">
541 <primary sortas="b-cupsd">cupsd</primary>
542 </indexterm>
543 </listitem>
544 </varlistentry>
545
546 <varlistentry id="cupsdisable">
547 <term><command>cupsdisable</command></term>
548 <listitem>
549 <para>
550 stop printers and classes.
551 </para>
552 <indexterm zone="cups cupsdisable">
553 <primary sortas="b-cupsdisable">cupsdisable</primary>
554 </indexterm>
555 </listitem>
556 </varlistentry>
557
558 <varlistentry id="cupsenable">
559 <term><command>cupsenable</command></term>
560 <listitem>
561 <para>
562 start printers and classes.
563 </para>
564 <indexterm zone="cups cupsenable">
565 <primary sortas="b-cupsenable">cupsenable</primary>
566 </indexterm>
567 </listitem>
568 </varlistentry>
569
570 <varlistentry id="cupsfilter">
571 <term><command>cupsfilter</command></term>
572 <listitem>
573 <para>
574 is a front-end to the <application>Cups</application>
575 filter subsystem which allows you to convert a file
576 to a specific format.
577 </para>
578 <indexterm zone="cups cupsfilter">
579 <primary sortas="b-cupsfilter">cupsfilter</primary>
580 </indexterm>
581 </listitem>
582 </varlistentry>
583
584 <varlistentry id="cupsreject">
585 <term><command>cupsreject</command></term>
586 <listitem>
587 <para>
588 reject jobs sent to a destination.
589 </para>
590 <indexterm zone="cups cupsreject">
591 <primary sortas="b-cupsreject">cupsreject</primary>
592 </indexterm>
593 </listitem>
594 </varlistentry>
595
596 <varlistentry id="cupstestdsc">
597 <term><command>cupstestdsc</command></term>
598 <listitem>
599 <para>
600 tests the conformance of PostScript files.
601 </para>
602 <indexterm zone="cups cupstestdsc">
603 <primary sortas="b-cupstestdsc">cupstestdsc</primary>
604 </indexterm>
605 </listitem>
606 </varlistentry>
607
608 <varlistentry id="cupstestppd">
609 <term><command>cupstestppd</command></term>
610 <listitem>
611 <para>
612 tests the conformance of PPD files.
613 </para>
614 <indexterm zone="cups cupstestppd">
615 <primary sortas="b-cupstestppd">cupstestppd</primary>
616 </indexterm>
617 </listitem>
618 </varlistentry>
619
620 <varlistentry id="ippfind">
621 <term><command>ippfind</command></term>
622 <listitem>
623 <para>
624 finds internet printing protocol printers.
625 </para>
626 <indexterm zone="cups ippfind">
627 <primary sortas="b-ippfind">ippfind</primary>
628 </indexterm>
629 </listitem>
630 </varlistentry>
631
632 <varlistentry id="ipptool">
633 <term><command>ipptool</command></term>
634 <listitem>
635 <para>
636 sends IPP requests to the specified URI and tests
637 and/or displays the results.
638 </para>
639 <indexterm zone="cups ipptool">
640 <primary sortas="b-ipptool">ipptool</primary>
641 </indexterm>
642 </listitem>
643 </varlistentry>
644
645 <varlistentry id="lp-cups">
646 <term><command>lp</command></term>
647 <listitem>
648 <para>
649 submits files for printing or alters a pending job.
650 </para>
651 <indexterm zone="cups lp-cups">
652 <primary sortas="b-lp">lp</primary>
653 </indexterm>
654 </listitem>
655 </varlistentry>
656
657 <varlistentry id="lpadmin">
658 <term><command>lpadmin</command></term>
659 <listitem>
660 <para>
661 configures printer and class queues provided by
662 <application>Cups</application>.
663 </para>
664 <indexterm zone="cups lpadmin">
665 <primary sortas="b-lpadmin">lpadmin</primary>
666 </indexterm>
667 </listitem>
668 </varlistentry>
669
670 <varlistentry id="lpc-cups">
671 <term><command>lpc</command></term>
672 <listitem>
673 <para>
674 provides limited control over printer and class queues
675 provided by <application>Cups</application>.
676 </para>
677 <indexterm zone="cups lpc-cups">
678 <primary sortas="b-lpc">lpc</primary>
679 </indexterm>
680 </listitem>
681 </varlistentry>
682
683 <varlistentry id="lpinfo">
684 <term><command>lpinfo</command></term>
685 <listitem>
686 <para>
687 lists the available devices or drivers known to the
688 <application>Cups</application> server.
689 </para>
690 <indexterm zone="cups lpinfo">
691 <primary sortas="b-lpinfo">lpinfo</primary>
692 </indexterm>
693 </listitem>
694 </varlistentry>
695
696 <varlistentry id="lpmove">
697 <term><command>lpmove</command></term>
698 <listitem>
699 <para>
700 moves the specified job to a new destination.
701 </para>
702 <indexterm zone="cups lpmove">
703 <primary sortas="b-lpmove">lpmove</primary>
704 </indexterm>
705 </listitem>
706 </varlistentry>
707
708 <varlistentry id="lpoptions">
709 <term><command>lpoptions</command></term>
710 <listitem>
711 <para>
712 displays or sets printer options and defaults.
713 </para>
714 <indexterm zone="cups lpoptions">
715 <primary sortas="b-lpoptions">lpoptions</primary>
716 </indexterm>
717 </listitem>
718 </varlistentry>
719
720 <varlistentry id="lpq-cups">
721 <term><command>lpq</command></term>
722 <listitem>
723 <para>
724 shows the current print queue status on the named printer.
725 </para>
726 <indexterm zone="cups lpq-cups">
727 <primary sortas="b-lpq">lpq</primary>
728 </indexterm>
729 </listitem>
730 </varlistentry>
731
732 <varlistentry id="lpr-cups">
733 <term><command>lpr</command></term>
734 <listitem>
735 <para>
736 submits files for printing.
737 </para>
738 <indexterm zone="cups lpr-cups">
739 <primary sortas="b-lpr">lpr</primary>
740 </indexterm>
741 </listitem>
742 </varlistentry>
743
744 <varlistentry id="lprm-cups">
745 <term><command>lprm</command></term>
746 <listitem>
747 <para>
748 cancels print jobs that have been queued for printing.
749 </para>
750 <indexterm zone="cups lprm-cups">
751 <primary sortas="b-lprm">lprm</primary>
752 </indexterm>
753 </listitem>
754 </varlistentry>
755
756 <varlistentry id="lpstat-cups">
757 <term><command>lpstat</command></term>
758 <listitem>
759 <para>
760 displays status information about the current classes, jobs,
761 and printers.
762 </para>
763 <indexterm zone="cups lpstat-cups">
764 <primary sortas="b-lpstat">lpstat</primary>
765 </indexterm>
766 </listitem>
767 </varlistentry>
768
769 <varlistentry id="ppdc">
770 <term><command>ppdc</command></term>
771 <listitem>
772 <para>
773 compiles PPDC source files into one or more PPD files.
774 </para>
775 <indexterm zone="cups ppdc">
776 <primary sortas="b-ppdc">ppdc</primary>
777 </indexterm>
778 </listitem>
779 </varlistentry>
780
781 <varlistentry id="ppdhtml">
782 <term><command>ppdhtml</command></term>
783 <listitem>
784 <para>
785 reads a driver information file and produces a HTML summary
786 page that lists all of the drivers in a file and the
787 supported options.
788 </para>
789 <indexterm zone="cups ppdhtml">
790 <primary sortas="b-ppdhtml">ppdhtml</primary>
791 </indexterm>
792 </listitem>
793 </varlistentry>
794
795 <varlistentry id="ppdi">
796 <term><command>ppdi</command></term>
797 <listitem>
798 <para>
799 imports one or more PPD files into a PPD compiler source file.
800 </para>
801 <indexterm zone="cups ppdi">
802 <primary sortas="b-ppdi">ppdi</primary>
803 </indexterm>
804 </listitem>
805 </varlistentry>
806
807 <varlistentry id="ppdmerge">
808 <term><command>ppdmerge</command></term>
809 <listitem>
810 <para>
811 merges two or more PPD files into a single, multi-language
812 PPD file.
813 </para>
814 <indexterm zone="cups ppdmerge">
815 <primary sortas="b-ppdmerge">ppdmerge</primary>
816 </indexterm>
817 </listitem>
818 </varlistentry>
819
820 <varlistentry id="ppdpo">
821 <term><command>ppdpo</command></term>
822 <listitem>
823 <para>
824 extracts UI strings from PPDC source files and
825 updates either a GNU gettext or Mac OS X strings
826 format message catalog source file for translation.
827 </para>
828 <indexterm zone="cups ppdpo">
829 <primary sortas="b-ppdpo">ppdpo</primary>
830 </indexterm>
831 </listitem>
832 </varlistentry>
833
834 <varlistentry id="reject">
835 <term><command>reject</command></term>
836 <listitem>
837 <para>
838 instructs the printing system to reject print jobs to the
839 specified destinations.
840 </para>
841 <indexterm zone="cups reject">
842 <primary sortas="b-reject">reject</primary>
843 </indexterm>
844 </listitem>
845 </varlistentry>
846
847 <varlistentry id="libcups">
848 <term><filename class="libraryfile">libcups.so</filename></term>
849 <listitem>
850 <para>
851 contains the <application>Cups</application> API functions.
852 </para>
853 <indexterm zone="cups libcups">
854 <primary sortas="c-libcups">libcups.so</primary>
855 </indexterm>
856 </listitem>
857 </varlistentry>
858
859 </variablelist>
860
861 </sect2>
862
863</sect1>
Note: See TracBrowser for help on using the repository browser.