[thirdparty/cups.git] / man / printers.conf.man

.\"
.\" "$Id: printers.conf.man 11022 2013-06-06 22:14:09Z msweet $"
.\"
.\"   printers.conf man page for CUPS.
.\"
.\"   Copyright 2007-2013 by Apple Inc.
.\"   Copyright 1997-2006 by Easy Software Products.
.\"
.\"   These coded instructions, statements, and computer programs are the
.\"   property of Apple Inc. and are protected by Federal copyright
.\"   law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\"   which should have been included with this file.  If this file is
.\"   file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.TH printers.conf 5 "CUPS" "29 April 2009" "Apple Inc."
.SH NAME
printers.conf \- printer configuration file for cups
.SH DESCRIPTION
The \fIprinters.conf\fR file defines the local printers that are
available. It is normally located in the \fI/etc/cups\fR directory and
is generated automatically by the \fIcupsd(8)\fR program when printers
are added or deleted.
.LP
Each line in the file can be a configuration directive, a blank line,
or a comment. Comment lines start with the # character.
.SH DIRECTIVES
.TP 5
<Printer name> ... </Printer>
.br
Defines a specific printer.
.TP 5
<DefaultPrinter name> ... </Printer>
.br
Defines a default printer.
.TP 5
Accepting Yes
.TP 5
Accepting No
.br
Specifies whether the printer is accepting new jobs.
.TP 5
AllowUser [ user @group ... ]
.br
Allows specific users and groups to print to the printer.
.TP 5
DenyUser [ user @group ... ]
.br
Prevents specific users and groups from printing to the printer.
.TP 5
DeviceURI uri
.br
Specifies the device URI for a printer.
.TP 5
ErrorPolicy abort-job
.TP 5
ErrorPolicy retry-current-job
.TP 5
ErrorPolicy retry-job
.TP 5
ErrorPolicy stop-printer
.br
Specifies the error policy for the printer.
.TP 5
Info text
.br
Specifies human-readable text describing the printer.
.TP 5
JobSheets banner banner
.br
Specifies the banner pages to use for the printer.
.TP 5
KLimit number
.br
Specifies the job-k-limit value for the printer.
.TP 5
Location text
.br
Specifies human-readable text describing the location of the printer.
.TP 5
OpPolicy name
.br
Specifies the operation policy for the printer.
.TP 5
PageLimit number
.br
Specifies the job-page-limit value for the printer.
.TP 5
PortMonitor monitor
.br
Specifies the port monitor for a printer.
.TP 5
QuotaPeriod seconds
.br
Specifies the job-quota-period value for the printer.
.TP 5
Shared Yes
.TP 5
Shared No
.br
Specifies whether the printer is shared.
.TP 5
State idle
.TP 5
State stopped
.br
Specifies the initial state of the printer (Idle or Stopped)
.TP 5
StateMessage text
.br
Specifies the message associated with the state.
.TP 5
StateTime seconds
.br
Specifies the date/time associated with the state.
.SH SEE ALSO
\fIclasses.conf(5)\fR, \fIcupsd(8)\fR, \fIcupsd.conf(5)\fR,
\fImime.convs(5)\fR, \fImime.types(5)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007-2013 by Apple Inc.
.\"
.\" End of "$Id: printers.conf.man 11022 2013-06-06 22:14:09Z msweet $".
.\"
Commit	Line	Data
	1	.\"
	2	.\" "$Id: printers.conf.man 11022 2013-06-06 22:14:09Z msweet $"
	3	.\"
	4	.\" printers.conf man page for CUPS.
	5	.\"
	6	.\" Copyright 2007-2013 by Apple Inc.
	7	.\" Copyright 1997-2006 by Easy Software Products.
	8	.\"
	9	.\" These coded instructions, statements, and computer programs are the
	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/".
	14	.\"
	15	.TH printers.conf 5 "CUPS" "29 April 2009" "Apple Inc."
	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
	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
	54	ErrorPolicy abort-job
	55	.TP 5
	56	ErrorPolicy retry-current-job
	57	.TP 5
	58	ErrorPolicy retry-job
	59	.TP 5
	60	ErrorPolicy stop-printer
	61	.br
	62	Specifies the error policy for the printer.
	63	.TP 5
	64	Info text
	65	.br
	66	Specifies human-readable text describing the printer.
	67	.TP 5
	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
	77	.br
	78	Specifies human-readable text describing the location of the printer.
	79	.TP 5
	80	OpPolicy name
	81	.br
	82	Specifies the operation policy for the printer.
	83	.TP 5
	84	PageLimit number
	85	.br
	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.
	91	.TP 5
	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
	105	.br
	106	Specifies the initial state of the printer (Idle or Stopped)
	107	.TP 5
	108	StateMessage text
	109	.br
	110	Specifies the message associated with the state.
	111	.TP 5
	112	StateTime seconds
	113	.br
	114	Specifies the date/time associated with the state.
	115	.SH SEE ALSO
	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
	120	.SH COPYRIGHT
	121	Copyright 2007-2013 by Apple Inc.
	122	.\"
	123	.\" End of "$Id: printers.conf.man 11022 2013-06-06 22:14:09Z msweet $".
	124	.\"