]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-printers.conf.html
Final sync-up with cups.org trunk repository
[thirdparty/cups.git] / doc / help / man-printers.conf.html
CommitLineData
94436c5a
MS
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>
11printers.conf - printer configuration file for cups
12<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
13The <i>printers.conf</i> file defines the local printers that are
14available. It is normally located in the <i>/etc/cups</i> directory and
15is generated automatically by the <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a> program when printers
16are added or deleted.
17<p>Each line in the file can be a configuration directive, a blank line,
18or 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>
141Copyright 2007-2013 by Apple Inc.
142
143</body>
144</html>