printers.conf - printer configuration file for cups


The printers.conf file defines the local printers that are available. It is normally located in the /etc/cups directory and is generated automatically by the cupsd(8) program when printers are added or deleted.

Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.


  • <Printer name> ... </Printer>
    Defines a specific printer.
  • <DefaultPrinter name> ... </Printer>
    Defines a default printer.
  • Accepting Yes
  • Accepting No
    Specifies whether the printer is accepting new jobs.
  • AllowUser [ user @group ... ]
    Allows specific users and groups to print to the printer.
  • DenyUser [ user @group ... ]
    Prevents specific users and groups from printing to the printer.
  • DeviceURI uri
    Specifies the device URI for a printer.
  • ErrorPolicy abort-job
  • ErrorPolicy retry-current-job
  • ErrorPolicy retry-job
  • ErrorPolicy stop-printer
    Specifies the error policy for the printer.
  • Info text
    Specifies human-readable text describing the printer.
  • JobSheets banner banner
    Specifies the banner pages to use for the printer.
  • KLimit number
    Specifies the job-k-limit value for the printer.
  • Location text
    Specifies human-readable text describing the location of the printer.
  • OpPolicy name
    Specifies the operation policy for the printer.
  • PageLimit number
    Specifies the job-page-limit value for the printer.
  • PortMonitor monitor
    Specifies the port monitor for a printer.
  • QuotaPeriod seconds
    Specifies the job-quota-period value for the printer.
  • Shared Yes
  • Shared No
    Specifies whether the printer is shared.
  • State idle
  • State stopped
    Specifies the initial state of the printer (Idle or Stopped)
  • StateMessage text
    Specifies the message associated with the state.
  • StateTime seconds
    Specifies the date/time associated with the state.


classes.conf(5), cupsd(8), cupsd.conf(5), mime.convs(5), mime.types(5),


Copyright 2007-2009 by Apple Inc.