Section: Apple Inc. (5)
Updated: CUPS
Index Return to Main Contents


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.