]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
e4e5666b | 2 | .\" "$Id$" |
ef416fc2 | 3 | .\" |
321d8d57 | 4 | .\" printers.conf man page for CUPS. |
ef416fc2 | 5 | .\" |
0fa6c7fa | 6 | .\" Copyright 2007-2013 by Apple Inc. |
bd7854cb | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 14 | .\" |
f11a948a | 15 | .TH printers.conf 5 "CUPS" "29 April 2009" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
17 | printers.conf \- printer configuration file for cups | |
18 | .SH DESCRIPTION | |
19 | The \fIprinters.conf\fR file defines the local printers that are | |
20 | available. It is normally located in the \fI/etc/cups\fR directory and | |
21 | is generated automatically by the \fIcupsd(8)\fR program when printers | |
22 | are added or deleted. | |
23 | .LP | |
24 | Each line in the file can be a configuration directive, a blank line, | |
25 | or a comment. Comment lines start with the # character. | |
26 | .SH DIRECTIVES | |
27 | .TP 5 | |
bd7854cb | 28 | <Printer name> ... </Printer> |
29 | .br | |
30 | Defines a specific printer. | |
31 | .TP 5 | |
32 | <DefaultPrinter name> ... </Printer> | |
33 | .br | |
34 | Defines a default printer. | |
35 | .TP 5 | |
36 | Accepting Yes | |
37 | .TP 5 | |
38 | Accepting No | |
39 | .br | |
40 | Specifies whether the printer is accepting new jobs. | |
41 | .TP 5 | |
42 | AllowUser [ user @group ... ] | |
43 | .br | |
44 | Allows specific users and groups to print to the printer. | |
45 | .TP 5 | |
46 | DenyUser [ user @group ... ] | |
47 | .br | |
48 | Prevents specific users and groups from printing to the printer. | |
49 | .TP 5 | |
50 | DeviceURI uri | |
51 | .br | |
52 | Specifies the device URI for a printer. | |
53 | .TP 5 | |
07725fee | 54 | ErrorPolicy abort-job |
bd7854cb | 55 | .TP 5 |
f11a948a MS |
56 | ErrorPolicy retry-current-job |
57 | .TP 5 | |
bd7854cb | 58 | ErrorPolicy retry-job |
59 | .TP 5 | |
60 | ErrorPolicy stop-printer | |
ef416fc2 | 61 | .br |
bd7854cb | 62 | Specifies the error policy for the printer. |
ef416fc2 | 63 | .TP 5 |
bd7854cb | 64 | Info text |
ef416fc2 | 65 | .br |
66 | Specifies human-readable text describing the printer. | |
67 | .TP 5 | |
bd7854cb | 68 | JobSheets banner banner |
69 | .br | |
70 | Specifies the banner pages to use for the printer. | |
71 | .TP 5 | |
72 | KLimit number | |
73 | .br | |
74 | Specifies the job-k-limit value for the printer. | |
75 | .TP 5 | |
76 | Location text | |
ef416fc2 | 77 | .br |
78 | Specifies human-readable text describing the location of the printer. | |
79 | .TP 5 | |
bd7854cb | 80 | OpPolicy name |
ef416fc2 | 81 | .br |
bd7854cb | 82 | Specifies the operation policy for the printer. |
ef416fc2 | 83 | .TP 5 |
bd7854cb | 84 | PageLimit number |
ef416fc2 | 85 | .br |
bd7854cb | 86 | Specifies the job-page-limit value for the printer. |
87 | .TP 5 | |
88 | PortMonitor monitor | |
89 | .br | |
90 | Specifies the port monitor for a printer. | |
ef416fc2 | 91 | .TP 5 |
bd7854cb | 92 | QuotaPeriod seconds |
93 | .br | |
94 | Specifies the job-quota-period value for the printer. | |
95 | .TP 5 | |
96 | Shared Yes | |
97 | .TP 5 | |
98 | Shared No | |
99 | .br | |
100 | Specifies whether the printer is shared. | |
101 | .TP 5 | |
102 | State idle | |
103 | .TP 5 | |
104 | State stopped | |
ef416fc2 | 105 | .br |
106 | Specifies the initial state of the printer (Idle or Stopped) | |
107 | .TP 5 | |
bd7854cb | 108 | StateMessage text |
ef416fc2 | 109 | .br |
110 | Specifies the message associated with the state. | |
bd7854cb | 111 | .TP 5 |
112 | StateTime seconds | |
113 | .br | |
114 | Specifies the date/time associated with the state. | |
ef416fc2 | 115 | .SH SEE ALSO |
bd7854cb | 116 | \fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR, |
117 | \fImime.convs(5)\fR, \fImime.types(5)\fR, | |
118 | .br | |
119 | http://localhost:631/help | |
ef416fc2 | 120 | .SH COPYRIGHT |
0fa6c7fa | 121 | Copyright 2007-2013 by Apple Inc. |
ef416fc2 | 122 | .\" |
e4e5666b | 123 | .\" End of "$Id$". |
ef416fc2 | 124 | .\" |