1cups-driverd(8)                   Apple Inc.                   cups-driverd(8)
2
3
4

NAME

6       cups-driverd - cups driver daemon
7

SYNOPSIS

9       cups-driverd cat ppd-name
10       cups-driverd list request_id limit options
11

DESCRIPTION

13       cups-driverd  shows  or lists PPD files. It is run in response to CUPS-
14       Add-Modify-Printer  or  CUPS-Get-Devices  requests.   The  first   form
15       ("cups-driverd  cat ppd-name") writes the named PPD file to stdout. The
16       output format is an uncompressed PPD file.
17
18       The second form lists the available manufacturers or PPD files to  std‐
19       out  as  indicated by the options argument. The output format is an IPP
20       response message. The request_id argument is the request  ID  from  the
21       original  IPP  request,  typically  1.  The limit argument is the limit
22       value from the original IPP request - 0 means no  limit.  Finally,  the
23       options  argument  is a space-delimited list of attributes ("name=value
24       name=value ...") that were passed in with the request. Currently  cups-
25       driverd  looks for the ppd-make and requested-attributes attributes and
26       tailors the output accordingly.
27

DRIVERS

29       Drivers can be static PPD files under the /usr/share/cups/model  direc‐
30       tory  or  programs under the /usr/lib/cups/driver directory. Static PPD
31       files must conform to the Adobe PPD File Format  Specification  version
32       4.3  and  may  be compressed using the gzip(1) program. Driver programs
33       must implement the command-line interface shown in the next section.
34
35   DRIVER PROGRAMS
36       Driver programs  provide  a   interface  to  dynamically-generated  PPD
37       files. The following arguments are currently defined:
38
39       drivername list
40            Lists the supported PPD files to stdout.
41
42       drivername cat ppdname
43            Writes the named PPD file to stdout.
44
45       Driver  programs MUST NOT query hardware or make other long-term opera‐
46       tions that would delay the return of a driver list. See the NOTES  sec‐
47       tion below for specific recommendations.
48
49   LISTING FILES (drivername list)
50       When  run  with  the  single argument "list", the program must list the
51       available PPD files it can generate to stdout using the following  for‐
52       mat:
53           "drivername:ppdname" language "make" "make and model"
54           "drivername:ppdname" language "make" "make and model" "1284 device id"
55           "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)"
56           "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version"
57           "drivername:ppdname" language "make" "make and model" "1284 device id" "(PPD product)" "PostScript version" "type"
58
59       Drivername  is the name of the driver program. Ppdname is the name used
60       to select the given driver. Language is the locale associated with  the
61       default  language of the PPD file, typically "en". Make is the Manufac‐
62       turer name from the PPD file. Make and model is the NickName name  from
63       the  PPD file. 1284 device id is the 1284DeviceId from the PPD file, if
64       any. (PPD product) is the Product string as it would appear in the  PPD
65       file  or  from  a PostScript query. PostScript version is the PSVersion
66       string as it would appear in the PPD file or from a  PostScript  query.
67       Type  is  "postscript" for PostScript printers, "pdf" for PDF printers,
68       "raster" for raster printers, or "fax" for facsimile devices.
69
70   WRITING FILES (drivername cat ppdname)
71       When the driver program is run with the  "cat  ppdname"  arguments,  it
72       must write the named PPD file to stdout, uncompressed. If the named PPD
73       file does not exist, the driver program must not write  any  output  to
74       stdout and report the error to stderr instead.
75
76   DRIVER ERROR MESSAGES
77       Error  messages can be relayed back to cupsd by writing them to stderr.
78       The following prefixes are recognized:
79
80       DEBUG: [drivername]
81            Debugging messages
82
83       ERROR: [drivername]
84            Error messages
85
86       INFO: [drivername]
87            Informational messages
88

NOTES

90       Due to performance considerations, driver programs have been officially
91       deprecated  and  should not be used for new development. Currently only
92       the CUPS web interface and lpinfo(8) command will  request  lists  from
93       all driver programs.
94

SEE ALSO

96       cupsd(8), cupsd.conf(5), cupstestppd(1), lpinfo(8),
97       http://localhost:631/help
98

100       Copyright 2007-2011 by Apple Inc.
101
102
103
1046 January 2011                       CUPS                      cups-driverd(8)
Impressum