1cups-driverd(8)             Easy Software Products             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 Ilimit 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 cups-driverd looks for the ppd-make and requested-attributes
25       attributes and tailors the output accordingly.
26

DRIVERS

28       Drivers  can be static PPD files under the /usr/share/cups/model direc‐
29       tory or programs under the /usr/lib/cups/driver directory.  Static  PPD
30       files  must  conform to the Adobe PPD File Format Specification version
31       4.3 and may be compressed using the gzip(1)  program.  Driver  programs
32       must  implement  the  command-line interface shown in the next section.
33       Driver programs  provide  an  interface  to  dynamically-generated  PPD
34       files. The following arguments are currently defined:
35
36       drivername list
37            Lists the supported PPD files to stdout.
38
39       drivername cat ppdname
40            Writes  the  named  PPD  file to stdout.  When run with the single
41            argument "list", the program must list the available PPD files  it
42            can generate to stdout using the following format:
43                "drivername:ppdname" language "make" "make and model" "1284 device id"
44
45       Drivername  is the name of the driver program. Ppdname is the name used
46       to select the given driver. Language is the locale associated with  the
47       default  language of the PPD file, typically "en". Make is the Manufac‐
48       turer name from the PPD file. Make and model is the NickName name  from
49       the  PPD file. 1284 device id is the 1284DeviceId from the PPD file, if
50       any.  When the driver program is run with the "cat ppdname"  arguments,
51       it  must write the named PPD file to stdout, uncompressed. If the named
52       PPD file does not exist, the driver program must not write  any  output
53       to  stdout  and report the error to stderr instead.  Error messages can
54       be relayed back to cupsd by writing them to stderr. The following  pre‐
55       fixes are recognized:
56
57       DEBUG: [drivername]
58            Debugging messages
59
60       ERROR: [drivername]
61            Error messages
62
63       INFO: [drivername]
64            Informational messages
65

SEE ALSO

67       cupsd(8), cupsd.conf(5), cupstestppd(1),
68       http://localhost:631/help
69

71       Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
72
73
74
7512 February 2006          Common UNIX Printing System          cups-driverd(8)
Impressum