doc/help/man-printers.conf.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <!-- SECTION: Man Pages -->
   4 <head>
   5         <link rel="stylesheet" type="text/css" href="../cups-printable.css">
   6         <title>printers.conf(5)</title>
   7 </head>
   8 <body>
   9 <h1 class="title">printers.conf(5)</h1>
  10 <h2 class="title"><a name="NAME">Name</a></h2>
  11 printers.conf - printer configuration file for cups
  12 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  13 The <i>printers.conf</i> file defines the local printers that are
  14 available. It is normally located in the <i>/etc/cups</i> directory and
  15 is generated automatically by the <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a> program when printers
  16 are added or deleted.
  17 <p>Each line in the file can be a configuration directive, a blank line,
  18 or a comment. Comment lines start with the # character.
  19 <h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
  20 <dl>
  21 <dt>&lt;Printer name> ... &lt;/Printer>
  22 </dt>
  23 <dd></dd>
  24 <dd>Defines a specific printer.
  25 </dd>
  26 <dt>&lt;DefaultPrinter name> ... &lt;/Printer>
  27 </dt>
  28 <dd></dd>
  29 <dd>Defines a default printer.
  30 </dd>
  31 <dt>Accepting Yes
  32 </dt>
  33 <dd></dd>
  34 <dt>Accepting No
  35 </dt>
  36 <dd></dd>
  37 <dd>Specifies whether the printer is accepting new jobs.
  38 </dd>
  39 <dt>AllowUser [ user @group ... ]
  40 </dt>
  41 <dd></dd>
  42 <dd>Allows specific users and groups to print to the printer.
  43 </dd>
  44 <dt>DenyUser [ user @group ... ]
  45 </dt>
  46 <dd></dd>
  47 <dd>Prevents specific users and groups from printing to the printer.
  48 </dd>
  49 <dt>DeviceURI uri
  50 </dt>
  51 <dd></dd>
  52 <dd>Specifies the device URI for a printer.
  53 </dd>
  54 <dt>ErrorPolicy abort-job
  55 </dt>
  56 <dd></dd>
  57 <dt>ErrorPolicy retry-current-job
  58 </dt>
  59 <dd></dd>
  60 <dt>ErrorPolicy retry-job
  61 </dt>
  62 <dd></dd>
  63 <dt>ErrorPolicy stop-printer
  64 </dt>
  65 <dd></dd>
  66 <dd>Specifies the error policy for the printer.
  67 </dd>
  68 <dt>Info text
  69 </dt>
  70 <dd></dd>
  71 <dd>Specifies human-readable text describing the printer.
  72 </dd>
  73 <dt>JobSheets banner banner
  74 </dt>
  75 <dd></dd>
  76 <dd>Specifies the banner pages to use for the printer.
  77 </dd>
  78 <dt>KLimit number
  79 </dt>
  80 <dd></dd>
  81 <dd>Specifies the job-k-limit value for the printer.
  82 </dd>
  83 <dt>Location text
  84 </dt>
  85 <dd></dd>
  86 <dd>Specifies human-readable text describing the location of the printer.
  87 </dd>
  88 <dt>OpPolicy name
  89 </dt>
  90 <dd></dd>
  91 <dd>Specifies the operation policy for the printer.
  92 </dd>
  93 <dt>PageLimit number
  94 </dt>
  95 <dd></dd>
  96 <dd>Specifies the job-page-limit value for the printer.
  97 </dd>
  98 <dt>PortMonitor monitor
  99 </dt>
 100 <dd></dd>
 101 <dd>Specifies the port monitor for a printer.
 102 </dd>
 103 <dt>QuotaPeriod seconds
 104 </dt>
 105 <dd></dd>
 106 <dd>Specifies the job-quota-period value for the printer.
 107 </dd>
 108 <dt>Shared Yes
 109 </dt>
 110 <dd></dd>
 111 <dt>Shared No
 112 </dt>
 113 <dd></dd>
 114 <dd>Specifies whether the printer is shared.
 115 </dd>
 116 <dt>State idle
 117 </dt>
 118 <dd></dd>
 119 <dt>State stopped
 120 </dt>
 121 <dd></dd>
 122 <dd>Specifies the initial state of the printer (Idle or Stopped)
 123 </dd>
 124 <dt>StateMessage text
 125 </dt>
 126 <dd></dd>
 127 <dd>Specifies the message associated with the state.
 128 </dd>
 129 <dt>StateTime seconds
 130 </dt>
 131 <dd></dd>
 132 <dd>Specifies the date/time associated with the state.
 133 </dd>
 134 </dl>
 135 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 136 <a href='man-classes.conf.html?TOPIC=Man+Pages'>classes.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>, <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>,
 137 <a href='man-mime.convs.html?TOPIC=Man+Pages'>mime.convs(5)</a>, <a href='man-mime.types.html?TOPIC=Man+Pages'>mime.types(5)</a>,
 138 <br>
 139 <a href='http://localhost:631/help'>http://localhost:631/help</a>
 140 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 141 Copyright 2007-2013 by Apple Inc.
 142
 143 </body>
 144 </html>