Book

The CUPS Book, "CUPS: Common UNIX Printing System", is the definitive guide to CUPS. Although originally written before CUPS 1.2 was released, the book is still relevant to current versions of CUPS and it an indispensible companion for any administrator or developer that uses CUPS. This page provides access to the example code in the book as well as corrections and updates since the book's publication.

The CUPS book, published by SAMS Publishing, may be purchased from Amazon.com. Note, however, that the companion CD is not provided with the book and is no longer available from the author. The sources from the original companion CD are provided here instead.

Table of Contents

Introduction [ Read ]

Part 1

• 1 - Introduction to CUPS
• 2 - Compiling and Installing CUPS
• 3 - Setting Up Printers and Classes
• 4 - Printing with CUPS
• 5 - Server Configuration
• 6 - Client Configuration

Part 2

• 7 - Overview of IPP
• 8 - Anatomy of an IPP Request
• 9 - Printer Objects
• 10 - Job Objects
• 11 - Subscription Objects
• 12 - CUPS Extensions to IPP

Part 3

• 13 - Overview of CUPS Programming
• 14 - Using CUPS API Functions
• 15 - Sending IPP Requests Using CUPS
• 16 - Writing File Filters for CUPS
• 17 - Writing Printer Drivers for CUPS
• 18 - Writing Backends for CUPS
• 19 - Writing Notifiers for CUPS

Part 4

• A - Configuration File Directives
• B - IPP Reference
• C - CUPS Constants
• D - CUPS Structures
• E - CUPS Functions
• F - Common UNIX Printing System License Agreement

Index

Errata

Page 10

The text:

... Additionally, IIP supports encryption ...

should read:

... Additionally, IPP supports encryption ...

Page 14

CUPS also now provides drivers for Dymo label printers using the dymo.ppd PPD file.

Page 16

KUPS has been superceded by KDE Print, available at:

http://printing.kde.org

Page 24

The correct command to extract the CUPS source code is:

tar xvzf /mnt/cdrom/source/cups-version-source.tar.gz ENTER

Page 25

The description for the PNG library contains part of the URL for the PNG home page.

Page 27

The correct option for specifying the font page is --with-fontpath and not --fontpath.

Page 28

The acronym SLP stands for Service Location Protocol, not Server Location Protocol.

Page 28

The --with-openslp-includes, --with-openslp-libs, --with-openssl-includes, and --with-openssl-libs configure options are not described.

Page 32

The correct script to run from the CD-ROM is install.sh and not cups.install.

Page 43

The text:

... DTE-DSR flow control would need the following device URI:

serial://dev/ttyS0?baud=19200+bits=7+parity=even+flow=dtedsr

should read:

... DTR-DSR flow control would need the following device URI:

serial:/dev/ttyS0?baud=19200+bits=7+parity=even+flow=dtrdsr

Page 57

The lpadmin example:

lpadmin -p name --o option=value ENTER

should read:

lpadmin -p name -o option=value ENTER

Page 78

The natural-scaling option is not described:

natural-scaling: Sets the size of the image in percent of the natural image size.

The natural-scaling value is a percentage from 1 to 800. The percentage is based on the natural image size and not the page size.

Examples

The examples are provided on the CUPS Companion CD-ROM in the examples directory:

examples
  |
  +-LICENSE.txt [License file referenced by sources]
  |
  +-chap13 [13 - Overview of CUPS Programming]
  |
  +-chap14 [14 - Using CUPS API Functions]
  |
  +-chap15 [15 - Sending IPP Requests Using CUPS]
  |
  +-chap17 [17 - Writing Printer Drivers for CUPS]

You can also download an archive of all the examples: examples.tar.gz