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  an  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   LISTING FILES (drivername list)
46       When  run  with  the  single argument "list", the program must list the
47       available PPD files it can generate to stdout using the following  for‐
48       mat:
49           "drivername:ppdname" language "make" "make and model" "1284 device id"
50
51       Drivername  is the name of the driver program. Ppdname is the name used
52       to select the given driver. Language is the locale associated with  the
53       default  language of the PPD file, typically "en". Make is the Manufac‐
54       turer name from the PPD file. Make and model is the NickName name  from
55       the  PPD file. 1284 device id is the 1284DeviceId from the PPD file, if
56       any.
57
58   WRITING FILES (drivername cat ppdname)
59       When the driver program is run with the  "cat  ppdname"  arguments,  it
60       must write the named PPD file to stdout, uncompressed. If the named PPD
61       file does not exist, the driver program must not write  any  output  to
62       stdout and report the error to stderr instead.
63
64   DRIVER ERROR MESSAGES
65       Error  messages can be relayed back to cupsd by writing them to stderr.
66       The following prefixes are recognized:
67
68       DEBUG: [drivername]
69            Debugging messages
70
71       ERROR: [drivername]
72            Error messages
73
74       INFO: [drivername]
75            Informational messages
76

SEE ALSO

78       cupsd(8), cupsd.conf(5), cupstestppd(1),
79       http://localhost:631/help
80
82       Copyright 2007-2009 by Apple Inc.
83
84
85
8616 June 2008                         CUPS                      cups-driverd(8)
Impressum