source: pst/printing/cups.xml@ d6c6562

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 d6c6562 was d6c6562, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Remove gcc7 entity

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

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