source: pst/printing/cups-systemd.xml@ ae2aab61

systemd-13485
Last change on this file since ae2aab61 was ae2aab61, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Add some more short descriptions by Denis.
Update to cups-filters-1.0.74
Update to poppler-0.35.0
Update to cups-2.1.0
Update to colord-1.2.12
Update to libgusb-0.2.6
Update to udisks-2.1.6
Update to gnome-themes-standard-3.16.2
Update to gnome-backgrounds-3.16.0
Update to caribou-0.4.18.1
Update to iso-codes-3.61
Update to NetworkManager-1.0.6
Update to bluez-5.34
Update to telepathy-logger-0.8.1

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16382 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 27.3 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 "c4e57a66298bfsba66bb3d5bedd317a4">
10 <!ENTITY cups-size "8.4 MB">
11 <!ENTITY cups-buildsize "92 MB">
12 <!ENTITY cups-time "0.8 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 &lfs77_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="llvm"/> (with Clang),
95 <xref linkend="mitkrb"/>,
96 <xref linkend="openjdk"/>,
97 <xref linkend="php"/>,
98 <xref linkend="python2"/> and
99 <xref linkend="xdg-utils"/>
100 </para>
101
102 <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
103 <para role="optional">
104 <xref linkend="cups-filters"/>
105 </para>
106
107 <bridgehead renderas="sect4">Optional (Runtime)</bridgehead>
108 <para role="optional">
109 <ulink url="https://www.openprinting.org/download/foomatic/">Foomatic</ulink>,
110 <xref linkend="gutenprint"/> and
111 <ulink url="http://hplipopensource.com/hplip-web/index.html">HPLIP</ulink> (HP printers)
112 </para>
113
114 <para condition="html" role="usernotes">User Notes:
115 <ulink url="&blfs-wiki;/cups"/>
116 </para>
117 </sect2>
118
119 <sect2 role="kernel" id="cups-kernel">
120 <title>Kernel Configuration</title>
121
122 <note>
123 <para>
124 There used to be a conflict between the <application>Cups</application>
125 <application>libusb</application> backend and the usblp kernel driver.
126 This is no longer the case and Cups will work with both of these
127 enabled.
128 </para>
129 </note>
130
131 <para>
132 If you want to use the kernel usblp driver (for example, if you wish to
133 use <application>escputil</application> from <xref
134 linkend="gutenprint"/>) enable the following options in your kernel
135 configuration and recompile the kernel:
136 </para>
137
138<screen><literal>Device Drivers ---&gt;
139 [*] USB support ---&gt; [CONFIG_USB_SUPPORT]
140 &lt;*/M&gt; OHCI HCD (USB 1.1) support [CONFIG_USB_OHCI_HCD]
141 &lt;*/M&gt; UHCI HCD (most Intel and VIA) support [CONFIG_USB_UHCI_HCD]
142 &lt;*/M&gt; USB Printer support [CONFIG_USB_PRINTER]</literal></screen>
143
144 <para>
145 If you have a parallel printer, enable the following options in your
146 kernel configuration and recompile the kernel:
147 </para>
148
149<screen><literal>Device Drivers ---&gt;
150 &lt;*/M&gt; Parallel port support ---&gt; [CONFIG_PARPORT]
151 &lt;*/M&gt; PC-style hardware [CONFIG_PARPORT_PC]
152 Character devices ---&gt;
153 &lt;*/M&gt; Parallel printer support [CONFIG_PRINTER]</literal></screen>
154
155 <indexterm zone="cups cups-kernel">
156 <primary sortas="d-cups">cups</primary>
157 </indexterm>
158
159 </sect2>
160
161 <sect2 role="installation">
162 <title>Installation of Cups</title>
163
164 <para>
165 You will need to add an <systemitem class="username">lp</systemitem>
166 user, as <application>Cups</application> will create some files owned
167 by this user. (The <systemitem class="username">lp</systemitem> user
168 is the default used by <application>Cups</application>, but may be
169 changed to a different user by passing a parameter to the
170 <command>configure</command> script.) Use the following command as
171 the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>useradd -c "Print Service User" -d /var/spool/cups -g lp -s /bin/false -u 9 lp</userinput></screen>
175
176 <para>
177 You will also need a dedicated group that will contain users allowed to
178 do <application>Cups</application> administrative tasks. Add the group
179 by running the following command as the
180 <systemitem class="username">root</systemitem> user:
181 </para>
182
183<screen role="root"><userinput>groupadd -g 19 lpadmin</userinput></screen>
184
185 <para>
186 If you want to add a user to the <application>Cups</application>
187 administrative group, run the following command as the
188 <systemitem class="username">root</systemitem> user:
189 </para>
190
191<screen role="root"><userinput>usermod -a -G lpadmin <replaceable>&lt;username&gt;</replaceable></userinput></screen>
192
193 <para>
194 If you didn't install <xref linkend="xdg-utils"/>, use the following
195 <command>sed</command> to change the default browser that will be used
196 to access the <application>Cups</application> web interface:
197 </para>
198
199<screen><userinput>sed -i 's#@CUPS_HTMLVIEW@#firefox#' desktop/cups.desktop.in</userinput></screen>
200
201 <para>
202 Replace <command>firefox</command> with the web browser of your
203 choice.
204 </para>
205
206 <!-- docdir is also document root for cups administration interface, so
207 let's just put it in /usr/share/cups/doc-&cups-version; and create symlink
208 in /usr/share/doc/cups-&cups-version;
209
210 When not using libdir switch, CUPS will install libraries into /usr/lib64
211 on a 64 bit system, and since /usr/lib64 is symlink to /usr/lib it might
212 introduce some difficulties with packaging -->
213
214 <para>
215 Build <application>Cups</application> by running the following commands:
216 </para>
217
218<screen><userinput>sed -i "s:555:755:g;s:444:644:g" Makedefs.in &amp;&amp;
219sed -i "/MAN.*.EXT/s:.gz::g" config-scripts/cups-manpages.m4 &amp;&amp;
220sed -i "/LIBGCRYPTCONFIG/d" config-scripts/cups-ssl.m4 &amp;&amp;
221sed -i 's@else /\* HAVE_AVAHI \*/@elif defined (HAVE_AVAHI)@' test/ippserver.c &amp;&amp;
222
223aclocal -I config-scripts &amp;&amp;
224autoconf -I config-scripts &amp;&amp;
225
226./configure --libdir=/usr/lib \
227 --with-rcdir=/tmp/cupsinit \
228 --with-system-groups=lpadmin \
229 --with-docdir=/usr/share/cups/doc-&cups-version; &amp;&amp;
230make</userinput></screen>
231
232 <para>
233 To test the results, issue: <command>make -k check</command> from
234 an X terminal emulator.
235 </para>
236
237 <para>
238 Now, as the <systemitem class="username">root</systemitem> user:
239 </para>
240
241<!-- dev note: make BUILDROOT=<DESTDIR> install -->
242
243<screen role="root"><userinput>make install &amp;&amp;
244rm -rf /tmp/cupsinit &amp;&amp;
245ln -sfnv ../cups/doc-&cups-version; /usr/share/doc/cups-&cups-version;</userinput></screen>
246
247 <para>
248 Create a basic <application>Cups</application> client configuration file
249 by running the following command as the <systemitem
250 class="username">root</systemitem> user:
251 </para>
252
253<screen role="root"><userinput>echo "ServerName /var/run/cups/cups.sock" > /etc/cups/client.conf</userinput></screen>
254
255 <para>
256 Remove filters that are now part of the <application>Cups
257 Filters</application> package by running the following commands as the
258 <systemitem class="username">root</systemitem> user:
259 </para>
260
261<screen role="root"><userinput>rm -rf /usr/share/cups/banners &amp;&amp;
262rm -rf /usr/share/cups/data/testprint</userinput></screen>
263
264 <note>
265 <para>
266 If you reinstall or update <application>Cups</application>, commands
267 above will break <xref linkend="cups-filters"/>, so it needs to be
268 reinstalled.
269 </para>
270 </note>
271
272 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
273 href="../../xincludes/gtk-update-icon-cache.xml"/>
274
275 </sect2>
276
277 <sect2 role="commands">
278 <title>Command Explanations</title>
279
280 <para>
281 <command>sed -i ... Makedefs.in</command>: This sed fixes
282 permissions of the installed files and directories.
283 </para>
284
285 <para>
286 <command>sed -i ... cups-manpages.m4</command>: This sed
287 prevents compression of the man pages by default.
288 </para>
289
290 <para>
291 <command>sed -i ... cups-ssl.m4</command>: This sed prevents
292 <command>configure</command> from looking for
293 <command>libgcrypt-config</command> because
294 <application>libgcrypt</application> is not required by the
295 package.
296 </para>
297
298 <para>
299 <command>sed -i ... test/ippserver.c</command>: This sed fixes a bug that
300 shows up when <xref linkend="avahi"/> is not present.
301 </para>
302 <para>
303 <parameter>--with-rcdir=/tmp/cupsinit</parameter>: This switch tells the
304 build process to install the shipped bootscript into <filename
305 class="directory">/tmp</filename> instead of <filename
306 class="directory">/etc/rc.d</filename>.
307 </para>
308
309 <para>
310 <parameter>--with-system-groups=lpadmin</parameter>: This switch ensures
311 that only <systemitem class="groupname">lpadmin</systemitem> will be used
312 as the <application>Cups</application> administrative group.
313 </para>
314
315 <para>
316 <option>--enable-libpaper</option>: Use this switch if you have installed
317 <application>libpaper</application> and wish to use it with
318 <application>Cups</application>.
319 </para>
320
321 </sect2>
322
323 <sect2 role="configuration">
324 <title>Configuring Cups</title>
325
326 <sect3 id="cups-config">
327 <title>Config Files</title>
328
329 <para><filename>/etc/cups/*</filename></para>
330
331 <indexterm zone="cups cups-config">
332 <primary sortas="e-etc-cups">/etc/cups/*</primary>
333 </indexterm>
334
335 </sect3>
336
337 <sect3>
338 <title>Configuration Information</title>
339
340 <para>
341 The <application>Cups</application> web interface can be accessed
342 via <ulink url="http://localhost:631"/>. From there, printers
343 and print jobs can be managed, and the server configuration
344 can be changed. Configuration can also be done from the command
345 line using the <command>lpadmin</command>,
346 <command>lpoptions</command> and <command>lpstat</command>
347 commands.
348 </para>
349
350 <para>
351 Configuration of <application>Cups</application> is dependent on
352 the type of printer and can be complex. Generally, PostScript printers
353 are easier. For detailed instructions on configuration and use of
354 <application>Cups</application>, see <ulink
355 url="http://www.cups.org/documentation.php"/>.
356 </para>
357
358 <para>
359 For non-PostScript printers to print with
360 <application>Cups</application>, you need to install <xref
361 linkend="gs"/> to convert PostScript to raster images and a driver
362 (e.g. from <xref linkend="gutenprint"/>) to convert the resulting
363 raster images to a form that the printer understands. <ulink
364 url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
365 drivers use <xref linkend="gs"/> to convert PostScript to a printable
366 form directly, but this is considered suboptimal by
367 <application>Cups</application> developers.
368 </para>
369
370 </sect3>
371
372 <sect3>
373 <title>Linux PAM Configuration</title>
374
375 <para>
376 If <application>CUPS</application> has been built with
377 <application>Linux PAM</application> support, you need to create a
378 <application>PAM</application> configuration file to get it working
379 correctly with BLFS.
380 </para>
381
382 <para>
383 Issue the following command as the <systemitem
384 class="username">root</systemitem> user to create the configuration
385 file for <application>Linux PAM</application>:
386 </para>
387
388<screen role="root"><userinput>cat &gt; /etc/pam.d/cups &lt;&lt; "EOF"
389<literal># Begin /etc/pam.d/cups
390
391auth include system-auth
392account include system-account
393session include system-session
394
395# End /etc/pam.d/cups</literal>
396EOF</userinput></screen>
397
398 </sect3>
399
400 <sect3 id="cups-init">
401 <title>Systemd Units</title>
402
403 <para>
404 To start the <command>cupsd</command> daemon when something tries to
405 access it, enable the previously installed systemd units by running
406 the following command as the
407 <systemitem class="username">root</systemitem> user:
408 </para>
409
410 <indexterm zone="cups cups-init">
411 <primary sortas="f-cups">cups</primary>
412 </indexterm>
413
414<screen role="root"><userinput>systemctl enable org.cups.cupsd</userinput></screen>
415
416 </sect3>
417
418 </sect2>
419
420 <sect2 role="content">
421 <title>Contents</title>
422
423 <segmentedlist>
424 <segtitle>Installed Programs</segtitle>
425 <segtitle>Installed Libraries</segtitle>
426 <segtitle>Installed Directories</segtitle>
427
428 <seglistitem>
429 <seg>
430 accept, cancel, cupsaccept, cupsaddsmb, cups-config, cupsctl, cupsd,
431 cupsdisable, cupsenable, cupsfilter, cupsreject, cupstestdsc,
432 cupstestppd, ippfind, ipptool, lp, lpadmin, lpc, lpinfo, lpmove,
433 lpoptions, lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge,
434 ppdpo and reject
435 </seg>
436 <seg>
437 libcupscgi.so, libcupsimage.so, libcupsmime.so,
438 libcupsppdc.so and libcups.so
439 </seg>
440 <seg>
441 /etc/cups,
442 /usr/include/cups,
443 /usr/lib/cups,
444 /usr/share/cups,
445 /usr/share/doc/cups-&cups-version;,
446 /var/cache/cups,
447 /var/log/cups,
448 /var/run/cups and
449 /var/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.