source: pst/printing/cups.xml@ b256695

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 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 b256695 was b256695, checked in by Ken Moffat <ken@…>, 7 years ago

Allow cupsd to start in the absence of kerberos.

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

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