projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| ef416fc2 | 1 | .\" |
| 75bd9771 | 2 | .\" "$Id: printers.conf.man 7600 2008-05-20 21:06:23Z mike $" |
| ef416fc2 | 3 | .\" |
| 4 | .\" printers.conf man page for the Common UNIX Printing System (CUPS). | |
| 5 | .\" | |
| c168a833 | 6 | .\" Copyright 2007-2009 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 |
| c168a833 | 121 | Copyright 2007-2009 by Apple Inc. |
| ef416fc2 | 122 | .\" |
| 75bd9771 | 123 | .\" End of "$Id: printers.conf.man 7600 2008-05-20 21:06:23Z mike $". |
| ef416fc2 | 124 | .\" |