|
Packit Service |
4ae4ad |
README - CUPS v2.2.6 - 2017-11-01
|
|
Packit Service |
4ae4ad |
=================================
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Looking for compile instructions? Read the file `INSTALL.md` instead...
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
INTRODUCTION
|
|
Packit Service |
4ae4ad |
------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS is a standards-based, open source printing system developed by Apple Inc.
|
|
Packit Service |
4ae4ad |
for macOS® and other UNIX®-like operating systems. CUPS uses the Internet
|
|
Packit Service |
4ae4ad |
Printing Protocol ("IPP") and provides System V and Berkeley command-line
|
|
Packit Service |
4ae4ad |
interfaces, a web interface, and a C API to manage printers and print jobs. It
|
|
Packit Service |
4ae4ad |
supports printing to both local (parallel, serial, USB) and networked printers,
|
|
Packit Service |
4ae4ad |
and printers can be shared from one computer to another, even over the Internet!
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Internally, CUPS uses PostScript Printer Description ("PPD") files to describe
|
|
Packit Service |
4ae4ad |
printer capabilities and features and a wide variety of generic and device-
|
|
Packit Service |
4ae4ad |
specific programs to convert and print many types of files. Sample drivers are
|
|
Packit Service |
4ae4ad |
included with CUPS to support many Dymo, EPSON, HP, Intellitech, OKIDATA, and
|
|
Packit Service |
4ae4ad |
Zebra printers. Many more drivers are available online and (in some cases) on
|
|
Packit Service |
4ae4ad |
the driver CD-ROM that came with your printer.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS is licensed under the GNU General Public License and GNU Library General
|
|
Packit Service |
4ae4ad |
Public License versions 2. See the file "LICENSE.txt" for more information.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
READING THE DOCUMENTATION
|
|
Packit Service |
4ae4ad |
-------------------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Once you have installed the software you can access the documentation (and a
|
|
Packit Service |
4ae4ad |
bunch of other stuff) online at <http://localhost:631/>.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
If you're having trouble getting that far, the documentation is located under
|
|
Packit Service |
4ae4ad |
the `doc/help` and `man` directories.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Please read the documentation before asking questions.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
GETTING SUPPORT AND OTHER RESOURCES
|
|
Packit Service |
4ae4ad |
-----------------------------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
If you have problems, *read the documentation first!* We also provide two
|
|
Packit Service |
4ae4ad |
mailing lists which are available at <https://lists.cups.org/mailman/listinfo>.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
See the CUPS web site at <https://www.cups.org/> for other resources.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER
|
|
Packit Service |
4ae4ad |
------------------------------------------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS includes a web-based administration tool that allows you to manage
|
|
Packit Service |
4ae4ad |
printers, classes, and jobs on your server. Open <http://localhost:631/admin/>
|
|
Packit Service |
4ae4ad |
in your browser to access the printer administration tools:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
*Do not* use the hostname for your machine - it will not work with the default
|
|
Packit Service |
4ae4ad |
CUPS configuration. To enable administration access on other addresses, check
|
|
Packit Service |
4ae4ad |
the `Allow Remote Administration` box and click on the `Change Settings button.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
You will be asked for the administration password (root or any other user in the
|
|
Packit Service |
4ae4ad |
sys/system/root/admin/lpadmin group on your system) when performing any
|
|
Packit Service |
4ae4ad |
administrative function.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE
|
|
Packit Service |
4ae4ad |
-----------------------------------------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS currently uses PPD (PostScript Printer Description) files that describe
|
|
Packit Service |
4ae4ad |
printer capabilities and driver programs needed for each printer. The
|
|
Packit Service |
4ae4ad |
`everywhere` PPD is used for nearly all modern networks printers sold since
|
|
Packit Service |
4ae4ad |
about 2009. For example, the following command creates a print queue for a
|
|
Packit Service |
4ae4ad |
printer at address 11.22.33.44:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS also includes several sample PPD files you can use for "legacy" printers:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Driver PPD Name
|
|
Packit Service |
4ae4ad |
----------------------------- ------------------------------
|
|
Packit Service |
4ae4ad |
Dymo Label Printers drv:///sample.drv/dymo.ppd
|
|
Packit Service |
4ae4ad |
Intellitech Intellibar drv:///sample.drv/intelbar.ppd
|
|
Packit Service |
4ae4ad |
EPSON 9-pin Series drv:///sample.drv/epson9.ppd
|
|
Packit Service |
4ae4ad |
EPSON 24-pin Series drv:///sample.drv/epson24.ppd
|
|
Packit Service |
4ae4ad |
Generic PCL Laser Printer drv:///sample.drv/generpcl.ppd
|
|
Packit Service |
4ae4ad |
Generic PostScript Printer drv:///sample.drv/generic.ppd
|
|
Packit Service |
4ae4ad |
HP DeskJet Series drv:///sample.drv/deskjet.ppd
|
|
Packit Service |
4ae4ad |
HP LaserJet Series drv:///sample.drv/laserjet.ppd
|
|
Packit Service |
4ae4ad |
OKIDATA 9-Pin Series drv:///sample.drv/okidata9.ppd
|
|
Packit Service |
4ae4ad |
OKIDATA 24-Pin Series drv:///sample.drv/okidat24.ppd
|
|
Packit Service |
4ae4ad |
Zebra CPCL Label Printer drv:///sample.drv/zebracpl.ppd
|
|
Packit Service |
4ae4ad |
Zebra EPL1 Label Printer drv:///sample.drv/zebraep1.ppd
|
|
Packit Service |
4ae4ad |
Zebra EPL2 Label Printer drv:///sample.drv/zebraep2.ppd
|
|
Packit Service |
4ae4ad |
Zebra ZPL Label Printer drv:///sample.drv/zebra.ppd
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
You can run the `lpinfo -m` command to list all of the available drivers:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpinfo -m
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Run the `lpinfo -v` command to list the available printers:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpinfo -v
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Then use the correct URI to add the printer using the `lpadmin` command:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v device-uri -m ppd-name
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Current network printers typically use `ipp` or `ipps` URIS:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v ipps://11.22.33.44/ipp/print -m everywhere
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Older network printers typically use `socket` or `lpd` URIs:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v socket://11.22.33.44 -m ppd-name
|
|
Packit Service |
4ae4ad |
lpadmin -p printername -E -v lpd://11.22.33.44/ -m ppd-name
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
The sample drivers provide basic printing capabilities, but generally do not
|
|
Packit Service |
4ae4ad |
exercise the full potential of the printers or CUPS. Other drivers provide
|
|
Packit Service |
4ae4ad |
greater printing capabilities.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
PRINTING FILES
|
|
Packit Service |
4ae4ad |
--------------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS provides both the System V `lp` and Berkeley `lpr` commands for printing:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lp filename
|
|
Packit Service |
4ae4ad |
lpr filename
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
Both the `lp` and `lpr` commands support printing options for the driver:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lp -o media=A4 -o resolution=600dpi filename
|
|
Packit Service |
4ae4ad |
lpr -o media=A4 -o resolution=600dpi filename
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS recognizes many types of images files as well as PDF, PostScript, and text
|
|
Packit Service |
4ae4ad |
files, so you can print those files directly rather than through an application.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
If you have an application that generates output specifically for your printer
|
|
Packit Service |
4ae4ad |
then you need to use the `-oraw` or `-l` options:
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
lp -o raw filename
|
|
Packit Service |
4ae4ad |
lpr -l filename
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
This will prevent the filters from misinterpreting your print file.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
LEGAL STUFF
|
|
Packit Service |
4ae4ad |
-----------
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS is copyright © 2007-2017 by Apple Inc. CUPS and the CUPS logo are
|
|
Packit Service |
4ae4ad |
trademarks of Apple Inc.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
The MD5 Digest code is Copyright 1999 Aladdin Enterprises.
|
|
Packit Service |
4ae4ad |
|
|
Packit Service |
4ae4ad |
CUPS is provided under the terms of version 2 of the GNU General Public License
|
|
Packit Service |
4ae4ad |
and GNU Library General Public License. This program is distributed in the hope
|
|
Packit Service |
4ae4ad |
that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
|
|
Packit Service |
4ae4ad |
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
Packit Service |
4ae4ad |
`doc/help/license.html` or `LICENSE.txt` files for more information.
|