Official CUPS Sources
C C++ Makefile M4 Shell Groff Other
Permalink
Failed to load latest commit information.
backend Optimize connection usage in the IPP backend. Jan 16, 2017
berkeley Fix source file header text duplication text duplication. Jan 16, 2017
cgi-bin Fix source file header text duplication text duplication. Jan 16, 2017
conf Fix source file header text duplication text duplication. Jan 16, 2017
config-scripts Fix source file header text duplication text duplication. Jan 16, 2017
cups Update API help files, fix annotation of some cups_printer_t enums. Jan 16, 2017
data Fix source file header text duplication text duplication. Jan 16, 2017
desktop Fix source file header text duplication text duplication. Jan 16, 2017
doc Update copyrights on man pages. Jan 16, 2017
examples Fix source file header text duplication text duplication. Jan 16, 2017
filter Fix source file header text duplication text duplication. Jan 16, 2017
locale Fix source file header text duplication text duplication. Jan 16, 2017
man Update copyrights on man pages. Jan 16, 2017
monitor Fix source file header text duplication text duplication. Jan 16, 2017
notifier Fix source file header text duplication text duplication. Jan 16, 2017
packaging Update packaging files (Issue #4940) Jan 3, 2017
ppdc Fix source file header text duplication text duplication. Jan 16, 2017
scheduler Fix source file header text duplication text duplication. Jan 16, 2017
systemv Fix source file header text duplication text duplication. Jan 16, 2017
templates Fix reporting of printed pages in the web interface (Issue #4924) Jan 16, 2017
test Fix source file header text duplication text duplication. Jan 16, 2017
tools Re-add gpg command. Jun 24, 2016
vcnet Fix source file header text duplication text duplication. Jan 16, 2017
xcode Fix source file header text duplication text duplication. Jan 16, 2017
.gitattributes Ignore all .git* files too. Apr 13, 2016
.gitignore Add new unit test program for testing credentials and the trust store. Aug 26, 2016
.mailmap Add a mailmap for correct work attribution Mar 17, 2016
CHANGES-1.0.txt Load cups into easysw/current. Jan 13, 2006
CHANGES-1.1.txt Load cups into easysw/current. Jan 13, 2006
CHANGES-1.2.txt Load cups into easysw/current. Jul 16, 2007
CHANGES-1.3.txt Merge changes from CUPS 1.4svn-r8722 (tentative 1.4.0 GM) Jun 18, 2009
CHANGES-1.4.txt Merge changes from CUPS 1.5.1-r9875. Aug 9, 2011
CHANGES-1.5.txt Merge changes from CUPS 1.7svn-r10578. Aug 29, 2012
CHANGES-1.6.txt Removed some duplicate size definitions for some ISO sizes that were … Aug 14, 2013
CHANGES-1.7.txt Sync up changelog. Jul 30, 2014
CHANGES-2.0.txt cupsd-logs man page should be in section 5 (STR #4674) Jul 30, 2015
CHANGES-2.1.txt Changelog. Jun 8, 2016
CHANGES.txt Fix reporting of printed pages in the web interface (Issue #4924) Jan 16, 2017
CONTRIBUTING.md Update all references to OS X to macOS. Jun 20, 2016
CREDITS.txt Update CREDITS.txt Sep 28, 2016
INSTALL.txt Bump version to 2.2.1. Oct 3, 2016
LICENSE.txt Update all references to OS X to macOS. Jun 20, 2016
Makedefs.in Fix source file header text duplication text duplication. Jan 16, 2017
Makefile Fix source file header text duplication text duplication. Jan 16, 2017
README.txt Add example for IPP Everywhere printers. Jan 16, 2017
config.h.in Remove ASL checks from configure script and config.h files. Oct 20, 2016
configure Fix source file header text duplication text duplication. Jan 16, 2017
configure.ac Fix source file header text duplication text duplication. Jan 16, 2017
cups-config.in Drop SVN stuff from version. Apr 13, 2016
install-sh Remove all of the Subversion keywords from various source files. Apr 12, 2016

README.txt

README - CUPS v2.2.2 - 2017-01-16
---------------------------------

Looking for compile instructions?  Read the file "INSTALL.txt" instead...


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!

    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.

    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) online at:

	http://localhost:631/

    If you're having trouble getting that far, the documentation is located
    under the "doc/help" directory.

    Please read the documentation before asking questions.


GETTING SUPPORT AND OTHER RESOURCES

    If you have problems, READ THE DOCUMENTATION FIRST!  We also provide two
    mailing lists which are available at:

	http://lists.cups.org/mailman/listinfo

    See the CUPS web site at "http://www.cups.org/" for other resources.


SETTING UP PRINTER QUEUES USING YOUR WEB 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/

    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.

    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 includes several sample PPD files you can use:

	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

    Run the "lpinfo -m" command to list the available drivers:

        lpinfo -m

    Run the "lpinfo -v" command to list the available printers:

        lpinfo -v

    Then use the correct URI to add the printer using the "lpadmin" command:

        lpadmin -p printername -E -v device-uri -m ppd-name

    Network printers typically use "socket" or "lpd" URIs:

        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

    The sample drivers provide basic printing capabilities, but generally do not
    exercise the full potential of the printers or CUPS.

    CUPS also supports IPP Everywhere printers using the "everywhere" model,
    for example:

        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:

	lp filename
	lpr filename

    Both the "lp" and "lpr" commands support printing options for the driver:

	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,
    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:

	lp -o raw filename
	lpr -l filename

    This will prevent the filters from misinterpreting your print file.


LEGAL STUFF

    CUPS is Copyright 2007-2017 by Apple Inc.  CUPS and the CUPS logo are
    trademarks of Apple Inc.

    The MD5 Digest code is Copyright 1999 Aladdin Enterprises.

    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.