1. NAME

printers.conf - printer configuration file for cups

2. DESCRIPTION

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.

3. DIRECTIVES

  • <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.

4. SEE ALSO

classes.conf(5), cupsd(8), cupsd.conf(5), mime.convs(5), mime.types(5),
http://localhost:631/help

5. COPYRIGHT

Copyright 2007-2009 by Apple Inc.