-README - CUPS v1.2.0b1 - 01/10/2006
------------------------------------
-
-*****************************************************************
-*****************************************************************
-**** ****
-**** WARNING: THIS IS BETA RELEASE SOFTWARE AND MAY BE ****
-**** TOTALLY UNSTABLE. DO NOT USE IN ENVIRONMENTS ****
-**** WHERE RELIABLE SOFTWARE IS REQUIRED! ****
-**** ****
-*****************************************************************
-*****************************************************************
-
-Looking for compile instructions? Read the file "INSTALL.txt"
-instead...
-
-*****************************************************************
-*****************************************************************
-**** ****
-**** IF YOU HAVE A NON-POSTSCRIPT PRINTER, YOU WILL ALSO ****
-**** NEED TO INSTALL ESP GHOSTSCRIPT OR A PATCHED VERSION ****
-**** OF A STANDARD GHOSTSCRIPT RELEASE. ****
-**** ****
-*****************************************************************
-*****************************************************************
+README - CUPS v2.2.2 - 2017-01-17
+---------------------------------
-
-INTRODUCTION
-
-CUPS provides a portable printing layer for UNIX(r)-based
-operating systems. It has been developed by Easy Software
-Products to promote a standard printing solution for all UNIX
-vendors and users. CUPS provides the System V and Berkeley
-command-line interfaces.
-
-CUPS uses the Internet Printing Protocol ("IPP") as the basis
-for managing print jobs and queues. The Line Printer Daemon
-("LPD") Server Message Block ("SMB"), and AppSocket (a.k.a.
-JetDirect) protocols are also supported with reduced
-functionality. CUPS adds network printer browsing and
-PostScript Printer Description ("PPD") based printing options to
-support real-world printing under UNIX.
-
-CUPS includes an image file RIP that supports printing of image
-files to non-PostScript printers. A customized version of GNU
-Ghostscript for CUPS called ESP Ghostscript is available
-separately to support printing of PostScript files within the
-CUPS driver framework. Sample drivers for Dymo, EPSON, HP, and
-OKIDATA printers are included that use these filters.
-
-Drivers for thousands of printers are provided with our ESP
-Print Pro software, available at:
-
- http://www.easysw.com/printpro/
-
-CUPS is licensed under the GNU General Public License and GNU
-Library General Public License. Please contact Easy Software
-Products for commercial support and "binary distribution"
-rights.
-
-
-SYSTEM REQUIREMENTS
-
-Binary distributions require a minimum of 10MB of free disk
-space. We do not recommend using CUPS on a workstation with less
-than 32MB of RAM or a PC with less than 16MB of RAM.
-
-If you are installing from source you'll need ANSI-compliant C
-and C++ compilers and optionally one or more image file support
-libraries. Complete source installation instructions can be
-found in the file "INSTALL.txt".
-
-
-SOFTWARE REQUIREMENTS
-
-The following operating system software is required to install
-one of the binary distributions from Easy Software Products:
-
- - AIX 4.3 or higher
- - HP-UX 11.00 or higher
- - IRIX 6.5 or higher
- - Linux 2.4 with glibc 2.2 or higher
- - Solaris 7 or higher (SPARC or Intel)
+Looking for compile instructions? Read the file "INSTALL.txt" instead...
-INSTALLING "PORTABLE" CUPS DISTRIBUTIONS
-
-We are currently distributing "portable" CUPS binary
-distributions in TAR format with installation and removal
-scripts generated by our ESP Package Manager (EPM) software,
-which is available from:
-
- http://www.easysw.com/epm
-
-WARNING: Installing CUPS will overwrite your existing printing
-system. Backup files are made by the installation script and
-restored by the removal script, so if you experience problems
-you should be able to remove the CUPS software to restore your
-previous configuration. However, Easy Software Products makes
-no warranty for this and will not be liable for any lost
-revenues, etc.
-
-To install the CUPS software you will need to be logged in as
-root (doing an "su" is good enough). Once you are the root
-user, run the installation script with:
-
- ./cups.install ENTER
-
-After asking you a few yes/no questions the CUPS software will
-be installed and the scheduler will be started automatically.
+INTRODUCTION
+ CUPS is a standards-based, open source printing system developed by Apple
+ Inc. for macOS® and other UNIX®-like operating systems. CUPS uses the
+ Internet Printing Protocol ("IPP") and provides System V and Berkeley
+ command-line interfaces, a web interface, and a C API to manage printers and
+ print jobs. It supports printing to both local (parallel, serial, USB) and
+ networked printers, and printers can be shared from one computer to another,
+ even over the Internet!
-INSTALLING HOST-SPECIFIC (RPM, DEBIAN, ETC.) DISTRIBUTIONS
+ Internally, CUPS uses PostScript Printer Description ("PPD") files to
+ describe printer capabilities and features and a wide variety of generic
+ and device-specific programs to convert and print many types of files.
+ Sample drivers are included with CUPS to support many Dymo, EPSON, HP,
+ Intellitech, OKIDATA, and Zebra printers. Many more drivers are available
+ online and (in some cases) on the driver CD-ROM that came with your printer.
-The host-specific distributions use the operating system
-software installation tools. To install a host-specific
-distribution please consult the CUPS Software Administrators
-Manual or your operating system documentation.
+ CUPS is licensed under the GNU General Public License and GNU Library
+ General Public License versions 2. See the file "LICENSE.txt" for more
+ information.
READING THE DOCUMENTATION
-Once you have installed the software you can access the
-documentation (and a bunch of other stuff) on-line at:
+ Once you have installed the software you can access the documentation (and
+ a bunch of other stuff) online at:
- http://localhost:631
+ http://localhost:631/
-If you're having trouble getting that far, the documentation is
-located in the "/usr/share/doc/cups" directory in the binary
-distributions, and under the "doc" directory in the source
-archives.
+ If you're having trouble getting that far, the documentation is located
+ under the "doc/help" directory.
-Please read the documentation before asking questions.
+ Please read the documentation before asking questions.
GETTING SUPPORT AND OTHER RESOURCES
-If you have problems, READ THE DOCUMENTATION FIRST! We also
-provide many discussion forums which are available at:
-
- http://www.cups.org/newsgroups.php
+ If you have problems, READ THE DOCUMENTATION FIRST! We also provide two
+ mailing lists which are available at:
-Commercial support (with a guaranteed response time) is available
-from Easy Software Products. For more information see:
+ http://lists.cups.org/mailman/listinfo
- http://www.easysw.com/cups/
-
-See the CUPS web site at "http://www.cups.org/" for other site
-links.
+ See the CUPS web site at "http://www.cups.org/" for other resources.
SETTING UP PRINTER QUEUES USING YOUR WEB BROWSER
-CUPS 1.2 includes a web-based administration tool that allows you
-to manage printers, classes, and jobs on your server. To access
-the printer administration tools open the following URL in your
-browser:
+ CUPS includes a web-based administration tool that allows you to manage
+ printers, classes, and jobs on your server. Open the following URL in your
+ browser to access the printer administration tools:
- http://localhost:631/admin
+ http://localhost:631/admin/
-You will be asked for the administration password (root or any
-other user in the sys/system/root group on your system) and then
-shown a menu of available functions.
+ DO NOT use the hostname for your machine - it will not work with the default
+ CUPS configuration. To enable administration access on other addresses,
+ check the "Allow Remote Administration" box and click on the "Change
+ Settings" button.
-DO NOT use the hostname for your machine - it will not work with
-the default CUPS configuration. To enable administration access
-on other addresses, consult the CUPS Software Administrators
-Manual.
+ You will be asked for the administration password (root or any other user in
+ the sys/system/root/admin/lpadmin group on your system) when performing any
+ administrative function.
SETTING UP PRINTER QUEUES FROM THE COMMAND-LINE
-CUPS works best with PPD (PostScript Printer Description)
-files. In a pinch you can also use System V style printer
-interface scripts.
+ CUPS works best with PPD (PostScript Printer Description) files. In a pinch
+ you can also use System V style printer interface scripts.
-Six sample PPD files are provided with this distribution that
-utilize the PostScript and image file RIPs and the sample EPSON
-and HP printer drivers. To add the sample DeskJet driver to the
-system for a printer connected to the parallel port, use one of
-the following commands:
+ CUPS includes several sample PPD files you can use:
- HP-UX:
+ Driver PPD Name
+ ----------------------------- ------------------------------
+ Dymo Label Printers drv:///sample.drv/dymo.ppd
+ Intellitech Intellibar drv:///sample.drv/intelbar.ppd
+ EPSON 9-pin Series drv:///sample.drv/epson9.ppd
+ EPSON 24-pin Series drv:///sample.drv/epson24.ppd
+ Generic PCL Laser Printer drv:///sample.drv/generpcl.ppd
+ Generic PostScript Printer drv:///sample.drv/generic.ppd
+ HP DeskJet Series drv:///sample.drv/deskjet.ppd
+ HP LaserJet Series drv:///sample.drv/laserjet.ppd
+ OKIDATA 9-Pin Series drv:///sample.drv/okidata9.ppd
+ OKIDATA 24-Pin Series drv:///sample.drv/okidat24.ppd
+ Zebra CPCL Label Printer drv:///sample.drv/zebracpl.ppd
+ Zebra EPL1 Label Printer drv:///sample.drv/zebraep1.ppd
+ Zebra EPL2 Label Printer drv:///sample.drv/zebraep2.ppd
+ Zebra ZPL Label Printer drv:///sample.drv/zebra.ppd
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/c2t0d0_lp -E
+ Run the "lpinfo -m" command to list the available drivers:
- IRIX:
+ lpinfo -m
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/plp -E
+ Run the "lpinfo -v" command to list the available printers:
- Linux:
+ lpinfo -v
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp0 -E
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp1 -E
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/lp2 -E
+ Then use the correct URI to add the printer using the "lpadmin" command:
- Solaris:
+ lpadmin -p printername -E -v device-uri -m ppd-name
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/bpp0 -E
- /usr/lib/lpadmin -p DeskJet -m deskjet.ppd -v parallel:/dev/ecpp0 -E
+ Network printers typically use "socket" or "lpd" URIs:
-Similarly, for the other sample drivers you can use:
+ lpadmin -p printername -E -v socket://11.22.33.44 -m ppd-name
+ lpadmin -p printername -E -v lpd://11.22.33.44/ -m ppd-name
- Driver PPD File
- ----------------------------- ------------
- Dymo Label Printers dymo.ppd
- EPSON Stylus Color Series stcolor.ppd
- EPSON Stylus Photo Series stphoto.ppd
- EPSON Stylus New Color Series stcolor2.ppd
- EPSON Stylus New Photo Series stphoto2.ppd
- EPSON 9-pin Series epson9.ppd
- EPSON 24-pin Series epson24.ppd
- HP DeskJet Series deskjet.ppd
- HP New DeskJet Series deskjet2.ppd
- HP LaserJet Series laserjet.ppd
- OKIDATA 9-Pin Series okidata9.ppd
- OKIDATA 24-Pin Series okidat24.ppd
+ The sample drivers provide basic printing capabilities, but generally do not
+ exercise the full potential of the printers or CUPS.
-These sample drivers provide basic printing capabilities, but
-generally do not exercise the full potential of the printers or
-CUPS. For commercial printer drivers check out our ESP Print
-Pro software at:
+ CUPS also supports IPP Everywhere printers using the "everywhere" model,
+ for example:
- http://www.easysw.com/printpro/
+ lpadmin -p printername -E -v ipp://11.22.33.44/ipp/print -m everywhere
PRINTING FILES
-CUPS provides both the System V "lp" and Berkeley "lpr" commands
-for printing:
+ CUPS provides both the System V "lp" and Berkeley "lpr" commands for
+ printing:
- lp filename
- lpr filename
+ lp filename
+ lpr filename
-Both the "lp" and "lpr" commands support printing options for
-the driver:
+ Both the "lp" and "lpr" commands support printing options for the driver:
- lp -omedia=A4 -oresolution=600dpi filename
- lpr -omedia=A4 -oresolution=600dpi filename
+ lp -o media=A4 -o resolution=600dpi filename
+ lpr -o media=A4 -o resolution=600dpi filename
-CUPS recognizes many types of images files as well as PDF,
-PostScript, HP-GL/2, and text files, so you can print those
-files directly rather than through an application.
+ CUPS recognizes many types of images files as well as PDF, PostScript,
+ and text files, so you can print those files directly rather than through
+ an application.
-If you have an application that generates output specifically
-for your printer then you need to use the "-oraw" or "-l"
-options:
+ If you have an application that generates output specifically for your
+ printer then you need to use the "-oraw" or "-l" options:
- lp -oraw filename
- lpr -l filename
+ lp -o raw filename
+ lpr -l filename
-This will prevent the filters from misinterpreting your print
-file.
+ This will prevent the filters from misinterpreting your print file.
LEGAL STUFF
-CUPS is Copyright 1993-2006 by Easy Software Products. CUPS,
-the CUPS logo, and the Common UNIX Printing System are the
-trademark property of Easy Software Products.
-
-The MD5 Digest code is Copyright 1999 Aladdin Enterprises.
-
-The PDF filter (pdftops) is based on the Xpdf software,
-Copyright 1996-2005 by Derek B. Noonburg.
-
-This software is based in part on the work of the Independent
-JPEG Group.
-
-CUPS is provided under the terms of the GNU General Public
-License and GNU Library General Public License. This program is
-distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY; without even the implied warranty of MERCHANTABILITY
-or FITNESS FOR A PARTICULAR PURPOSE. See the "LICENSE.html",
-"LICENSE.txt", or "cups.license" files for more information.
-
-For commercial licensing information, please contact:
-
- Attn: CUPS Licensing Information
- Easy Software Products
- 44141 Airport View Drive, Suite 204
- Hollywood, Maryland 20636 USA
+ CUPS is Copyright 2007-2017 by Apple Inc. CUPS and the CUPS logo are
+ trademarks of Apple Inc.
- Voice: +1.301.373.9600
- Email: cups-info@cups.org
- WWW: http://www.cups.org
+ The MD5 Digest code is Copyright 1999 Aladdin Enterprises.
-Note that commercial licensors may also require a license from
-Derek B. Noonburg who developed the Xpdf software used to print
-PDF files.
+ CUPS is provided under the terms of version 2 of the GNU General Public
+ License and GNU Library General Public License. This program is distributed
+ in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
+ the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the "doc/help/license.html" or "LICENSE.txt" files for more information.
projects / thirdparty / cups.git / blobdiff