source: pst/printing/cups.xml@ 8dfc5c3

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 8dfc5c3 was 8f26838, checked in by Pierre Labastie <pieere@…>, 7 years ago

Fix Cups-2.2.4 failure to find printers when no default printer is defined

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