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 cancel-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),

http://localhost:631/help

Copyright 1997-2006 by Easy Software Products, All Rights Reserved.