]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-printers.conf.html
Initial work on man page modernization (STR #4372)
[thirdparty/cups.git] / doc / help / man-printers.conf.html
CommitLineData
c277f98c 1<!DOCTYPE HTML>
94436c5a
MS
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
c277f98c 15is generated automatically by the <i>cupsd(8)</i> program when printers
94436c5a
MS
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>
c277f98c
MS
20<p style="margin-left: 5.0em; text-indent: -5.0em">&lt;Printer name> ... &lt;/Printer>
21<br>
22<br>
23Defines a specific printer.
24<p style="margin-left: 5.0em; text-indent: -5.0em">&lt;DefaultPrinter name> ... &lt;/Printer>
25<br>
26<br>
27Defines 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>
33Specifies 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>
37Allows 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>
41Prevents 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>
45Specifies 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>
55Specifies the error policy for the printer.
56<p style="margin-left: 5.0em; text-indent: -5.0em">Info text
57<br>
58<br>
59Specifies human-readable text describing the printer.
60<p style="margin-left: 5.0em; text-indent: -5.0em">JobSheets banner banner
61<br>
62<br>
63Specifies 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>
67Specifies 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>
71Specifies 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>
75Specifies the operation policy for the printer.
76<p style="margin-left: 5.0em; text-indent: -5.0em">PageLimit number
77<br>
78<br>
79Specifies 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>
83Specifies the port monitor for a printer.
84<p style="margin-left: 5.0em; text-indent: -5.0em">QuotaPeriod seconds
85<br>
86<br>
87Specifies 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>
93Specifies 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>
99Specifies 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>
103Specifies the message associated with the state.
104<p style="margin-left: 5.0em; text-indent: -5.0em">StateTime seconds
105<br>
106<br>
107Specifies the date/time associated with the state.
94436c5a 108<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c
MS
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>,
94436c5a 111<br>
c277f98c 112<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
113<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
114Copyright 2007-2013 by Apple Inc.
115
116</body>
117</html>