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