man/printers.conf.man

   1 .\"
   2 .\" "$Id: printers.conf.man 5969 2006-09-19 20:09:24Z mike $"
   3 .\"
   4 .\"   printers.conf man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2006 by Easy Software Products.
   7 .\"
   8 .\"   These coded instructions, statements, and computer programs are the
   9 .\"   property of Easy Software Products and are protected by Federal
  10 .\"   copyright law.  Distribution and use rights are outlined in the file
  11 .\"   "LICENSE.txt" which should have been included with this file.  If this
  12 .\"   file is missing or damaged please contact Easy Software Products
  13 .\"   at:
  14 .\"
  15 .\"       Attn: CUPS Licensing Information
  16 .\"       Easy Software Products
  17 .\"       44141 Airport View Drive, Suite 204
  18 .\"       Hollywood, Maryland 20636 USA
  19 .\"
  20 .\"       Voice: (301) 373-9600
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH printers.conf 5 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
  25 .SH NAME
  26 printers.conf \- printer configuration file for cups
  27 .SH DESCRIPTION
  28 The \fIprinters.conf\fR file defines the local printers that are
  29 available. It is normally located in the \fI/etc/cups\fR directory and
  30 is generated automatically by the \fIcupsd(8)\fR program when printers
  31 are added or deleted.
  32 .LP
  33 Each line in the file can be a configuration directive, a blank line,
  34 or a comment. Comment lines start with the # character.
  35 .SH DIRECTIVES
  36 .TP 5
  37 <Printer name> ... </Printer>
  38 .br
  39 Defines a specific printer.
  40 .TP 5
  41 <DefaultPrinter name> ... </Printer>
  42 .br
  43 Defines a default printer.
  44 .TP 5
  45 Accepting Yes
  46 .TP 5
  47 Accepting No
  48 .br
  49 Specifies whether the printer is accepting new jobs.
  50 .TP 5
  51 AllowUser [ user @group ... ]
  52 .br
  53 Allows specific users and groups to print to the printer.
  54 .TP 5
  55 DenyUser [ user @group ... ]
  56 .br
  57 Prevents specific users and groups from printing to the printer.
  58 .TP 5
  59 DeviceURI uri
  60 .br
  61 Specifies the device URI for a printer.
  62 .TP 5
  63 ErrorPolicy abort-job
  64 .TP 5
  65 ErrorPolicy retry-job
  66 .TP 5
  67 ErrorPolicy stop-printer
  68 .br
  69 Specifies the error policy for the printer.
  70 .TP 5
  71 Info text
  72 .br
  73 Specifies human-readable text describing the printer.
  74 .TP 5
  75 JobSheets banner banner
  76 .br
  77 Specifies the banner pages to use for the printer.
  78 .TP 5
  79 KLimit number
  80 .br
  81 Specifies the job-k-limit value for the printer.
  82 .TP 5
  83 Location text
  84 .br
  85 Specifies human-readable text describing the location of the printer.
  86 .TP 5
  87 OpPolicy name
  88 .br
  89 Specifies the operation policy for the printer.
  90 .TP 5
  91 PageLimit number
  92 .br
  93 Specifies the job-page-limit value for the printer.
  94 .TP 5
  95 PortMonitor monitor
  96 .br
  97 Specifies the port monitor for a printer.
  98 .TP 5
  99 QuotaPeriod seconds
 100 .br
 101 Specifies the job-quota-period value for the printer.
 102 .TP 5
 103 Shared Yes
 104 .TP 5
 105 Shared No
 106 .br
 107 Specifies whether the printer is shared.
 108 .TP 5
 109 State idle
 110 .TP 5
 111 State stopped
 112 .br
 113 Specifies the initial state of the printer (Idle or Stopped)
 114 .TP 5
 115 StateMessage text
 116 .br
 117 Specifies the message associated with the state.
 118 .TP 5
 119 StateTime seconds
 120 .br
 121 Specifies the date/time associated with the state.
 122 .SH SEE ALSO
 123 \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
 124 \fImime.convs(5)\fR, \fImime.types(5)\fR,
 125 .br
 126 http://localhost:631/help
 127 .SH COPYRIGHT
 128 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
 129 .\"
 130 .\" End of "$Id: printers.conf.man 5969 2006-09-19 20:09:24Z mike $".
 131 .\"