source: pst/printing/cups.xml@ 0e6eeb8

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 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 0e6eeb8 was 0e6eeb8, checked in by DJ Lucas <dj@…>, 7 years ago

Minor text fixups for cups.

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

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