Back to CUPS 1.7 Documents



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.

See Also

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


Copyright 2007-2013 by Apple Inc.