doc/help/man-printers.conf.html

   1 <!DOCTYPE HTML>
   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 <i>cupsd(8)</i> 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 <p style="margin-left: 5.0em; text-indent: -5.0em">&lt;Printer name> ... &lt;/Printer>
  21 <br>
  22 <br>
  23 Defines a specific printer.
  24 <p style="margin-left: 5.0em; text-indent: -5.0em">&lt;DefaultPrinter name> ... &lt;/Printer>
  25 <br>
  26 <br>
  27 Defines a default printer.
  28 <p style="margin-left: 5.0em; text-indent: -5.0em">Accepting Yes
  29 <br>
  30 <p style="margin-left: 5.0em; text-indent: -5.0em">Accepting No
  31 <br>
  32 <br>
  33 Specifies whether the printer is accepting new jobs.
  34 <p style="margin-left: 5.0em; text-indent: -5.0em">AllowUser [ user @group ... ]
  35 <br>
  36 <br>
  37 Allows specific users and groups to print to the printer.
  38 <p style="margin-left: 5.0em; text-indent: -5.0em">DenyUser [ user @group ... ]
  39 <br>
  40 <br>
  41 Prevents specific users and groups from printing to the printer.
  42 <p style="margin-left: 5.0em; text-indent: -5.0em">DeviceURI uri
  43 <br>
  44 <br>
  45 Specifies the device URI for a printer.
  46 <p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy abort-job
  47 <br>
  48 <p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-current-job
  49 <br>
  50 <p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy retry-job
  51 <br>
  52 <p style="margin-left: 5.0em; text-indent: -5.0em">ErrorPolicy stop-printer
  53 <br>
  54 <br>
  55 Specifies the error policy for the printer.
  56 <p style="margin-left: 5.0em; text-indent: -5.0em">Info text
  57 <br>
  58 <br>
  59 Specifies human-readable text describing the printer.
  60 <p style="margin-left: 5.0em; text-indent: -5.0em">JobSheets banner banner
  61 <br>
  62 <br>
  63 Specifies the banner pages to use for the printer.
  64 <p style="margin-left: 5.0em; text-indent: -5.0em">KLimit number
  65 <br>
  66 <br>
  67 Specifies the job-k-limit value for the printer.
  68 <p style="margin-left: 5.0em; text-indent: -5.0em">Location text
  69 <br>
  70 <br>
  71 Specifies human-readable text describing the location of the printer.
  72 <p style="margin-left: 5.0em; text-indent: -5.0em">OpPolicy name
  73 <br>
  74 <br>
  75 Specifies the operation policy for the printer.
  76 <p style="margin-left: 5.0em; text-indent: -5.0em">PageLimit number
  77 <br>
  78 <br>
  79 Specifies the job-page-limit value for the printer.
  80 <p style="margin-left: 5.0em; text-indent: -5.0em">PortMonitor monitor
  81 <br>
  82 <br>
  83 Specifies the port monitor for a printer.
  84 <p style="margin-left: 5.0em; text-indent: -5.0em">QuotaPeriod seconds
  85 <br>
  86 <br>
  87 Specifies the job-quota-period value for the printer.
  88 <p style="margin-left: 5.0em; text-indent: -5.0em">Shared Yes
  89 <br>
  90 <p style="margin-left: 5.0em; text-indent: -5.0em">Shared No
  91 <br>
  92 <br>
  93 Specifies whether the printer is shared.
  94 <p style="margin-left: 5.0em; text-indent: -5.0em">State idle
  95 <br>
  96 <p style="margin-left: 5.0em; text-indent: -5.0em">State stopped
  97 <br>
  98 <br>
  99 Specifies the initial state of the printer (Idle or Stopped)
 100 <p style="margin-left: 5.0em; text-indent: -5.0em">StateMessage text
 101 <br>
 102 <br>
 103 Specifies the message associated with the state.
 104 <p style="margin-left: 5.0em; text-indent: -5.0em">StateTime seconds
 105 <br>
 106 <br>
 107 Specifies the date/time associated with the state.
 108 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
 109 <i>classes.conf(5)</i>, <i>cupsd(8)</i>, <i>cupsd.conf(5)</i>,
 110 <i>mime.convs(5)</i>, <i>mime.types(5)</i>,
 111 <br>
 112 <a href="http://localhost:631/help">http://localhost:631/help</a>
 113 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
 114 Copyright 2007-2013 by Apple Inc.
 115
 116 </body>
 117 </html>