source: pst/printing/cups.xml@ 9c032d6

12.0 12.1 12.2 gimp3 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128 xry111/xf86-video-removal
Last change on this file since 9c032d6 was 962285d5, checked in by Xi Ruoyao <xry111@…>, 16 months ago

cups: Remove outdated desc. for CC=

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