Manual Reference Pages  - printers.conf (5)


printers.conf - printer configuration file for cups


See Also


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-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 by Apple Inc.

12 February 2006 printers.conf (5) Common UNIX Printing System
blog comments powered by Disqus