cups-driverd - cups driver daemon
cups-driverd cat ppd-name cups-driverd list request_id limit options
cups-driverd(8) Apple Inc. cups-driverd(8)
NAME
cups-driverd - cups driver daemon
SYNOPSIS
cups-driverd cat ppd-name
cups-driverd list request_id limit options
DESCRIPTION
cups-driverd shows or lists PPD files. It is run in response to CUPS-
Add-Modify-Printer or CUPS-Get-Devices requests. The first form
("cups-driverd cat ppd-name") writes the named PPD file to stdout. The
output format is an uncompressed PPD file.
The second form lists the available manufacturers or PPD files to std-
out as indicated by the options argument. The output format is an IPP
response message. The request_id argument is the request ID from the
original IPP request, typically 1. The limit argument is the limit
value from the original IPP request - 0 means no limit. Finally, the
options argument is a space-delimited list of attributes ("name=value
name=value ...") that were passed in with the request. Currently cups-
driverd looks for the ppd-make and requested-attributes attributes and
tailors the output accordingly.
DRIVERS
Drivers can be static PPD files under the /usr/share/cups/model direc-
tory or programs under the /usr/lib/cups/driver directory. Static PPD
files must conform to the Adobe PPD File Format Specification version
4.3 and may be compressed using the gzip(1) program. Driver programs
must implement the command-line interface shown in the next section.
DRIVER PROGRAMS
Driver programs provide an interface to dynamically-generated PPD
files. The following arguments are currently defined:
drivername list
Lists the supported PPD files to stdout.
drivername cat ppdname
Writes the named PPD file to stdout.
LISTING FILES (drivername list)
When run with the single argument "list", the program must list the
available PPD files it can generate to stdout using the following for-
mat:
"drivername:ppdname" language "make" "make and model" "1284 device id"
Drivername is the name of the driver program. Ppdname is the name used
to select the given driver. Language is the locale associated with the
default language of the PPD file, typically "en". Make is the Manufac-
turer name from the PPD file. Make and model is the NickName name from
the PPD file. 1284 device id is the 1284DeviceId from the PPD file, if
any.
WRITING FILES (drivername cat ppdname)
When the driver program is run with the "cat ppdname" arguments, it
must write the named PPD file to stdout, uncompressed. If the named PPD
file does not exist, the driver program must not write any output to
stdout and report the error to stderr instead.
DRIVER ERROR MESSAGES
Error messages can be relayed back to cupsd by writing them to stderr.
The following prefixes are recognized:
DEBUG: [drivername]
Debugging messages
ERROR: [drivername]
Error messages
INFO: [drivername]
Informational messages
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | print/cups |
+---------------+------------------+
|Stability | Volatile |
+---------------+------------------+
SEE ALSO
cupsd(8), cupsd.conf(5), cupstestppd(1),
http://localhost:631/help
COPYRIGHT
Copyright 2007-2009 by Apple Inc.
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original community
source was downloaded from
http://ftp.easysw.com/pub/cups/1.4.5/cups-1.4.5-source.tar.bz2
Further information about this software can be found on the open source
community website at http://www.cups.org/.
16 June 2008 CUPS cups-driverd(8)