Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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(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(7) 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://github.com/oracle/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)