[thirdparty/cups.git] / man / cupsaccept.man

.\"
.\" "$Id$"
.\"
.\"   accept/reject 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 cupsaccept 8 "CUPS" "12 February 2006" "Apple Inc."
.SH NAME
cupsaccept/cupsreject \- accept/reject jobs sent to a destination
.SH SYNOPSIS
.B cupsaccept
[ -E ] [ -U
.I username
] [ -h
.I hostname[:port]
] destination(s)
.br
.B cupsreject
[ -E ] [ -U
.I username
] [ -h
.I hostname[:port]
] [ -r
.I reason
] destination(s)
.SH DESCRIPTION
\fIcupsaccept\fR instructs the printing system to accept print jobs to the
specified destinations.
.LP
\fIcupsreject\fR instructs the printing system to reject print jobs to the
specified destinations. The \fI-r\fR option sets the reason for rejecting
print jobs. If not specified the reason defaults to "Reason Unknown".
.SH OPTIONS
The following options are supported by both \fIcupsaccept\fR and
\fIcupsreject\fR:
.TP 5
-E
.br
Forces encryption when connecting to the server.
.TP 5
-U username
.br
Sets the username that is sent when connecting to the server.
.TP 5
-h hostname[:port]
.br
Chooses an alternate server.
.TP 5
-r "reason"
.br
Sets the reason string that is shown for a printer that is
rejecting jobs.
.SH COMPATIBILITY
Unlike the System V printing system, CUPS allows printer names to
contain any printable character except SPACE, TAB, "/", or "#".
Also, printer and class names are \fInot\fR case-sensitive.
.LP
The CUPS versions of \fIaccept\fR and \fIreject\fR may ask the
user for an access password depending on the printing system
configuration. This differs from the System V versions which
require the root user to execute these commands.
.SH SEE ALSO
\fIcancel(1)\fR, \fIcupsenable(8)\fR, \fIlp(1)\fR,
\fIlpadmin(8)\fR, \fIlpstat(1)\fR,
.br
http://localhost:631/help
.SH COPYRIGHT
Copyright 2007-2013 by Apple Inc.
.\"
.\" End of "$Id$".
.\"
Commit	Line	Data
	1	.\"
	2	.\" "$Id$"
	3	.\"
	4	.\" accept/reject 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 cupsaccept 8 "CUPS" "12 February 2006" "Apple Inc."
	16	.SH NAME
	17	cupsaccept/cupsreject \- accept/reject jobs sent to a destination
	18	.SH SYNOPSIS
	19	.B cupsaccept
	20	[ -E ] [ -U
	21	.I username
	22	] [ -h
	23	.I hostname[:port]
	24	] destination(s)
	25	.br
	26	.B cupsreject
	27	[ -E ] [ -U
	28	.I username
	29	] [ -h
	30	.I hostname[:port]
	31	] [ -r
	32	.I reason
	33	] destination(s)
	34	.SH DESCRIPTION
	35	\fIcupsaccept\fR instructs the printing system to accept print jobs to the
	36	specified destinations.
	37	.LP
	38	\fIcupsreject\fR instructs the printing system to reject print jobs to the
	39	specified destinations. The \fI-r\fR option sets the reason for rejecting
	40	print jobs. If not specified the reason defaults to "Reason Unknown".
	41	.SH OPTIONS
	42	The following options are supported by both \fIcupsaccept\fR and
	43	\fIcupsreject\fR:
	44	.TP 5
	45	-E
	46	.br
	47	Forces encryption when connecting to the server.
	48	.TP 5
	49	-U username
	50	.br
	51	Sets the username that is sent when connecting to the server.
	52	.TP 5
	53	-h hostname[:port]
	54	.br
	55	Chooses an alternate server.
	56	.TP 5
	57	-r "reason"
	58	.br
	59	Sets the reason string that is shown for a printer that is
	60	rejecting jobs.
	61	.SH COMPATIBILITY
	62	Unlike the System V printing system, CUPS allows printer names to
	63	contain any printable character except SPACE, TAB, "/", or "#".
	64	Also, printer and class names are \fInot\fR case-sensitive.
	65	.LP
	66	The CUPS versions of \fIaccept\fR and \fIreject\fR may ask the
	67	user for an access password depending on the printing system
	68	configuration. This differs from the System V versions which
	69	require the root user to execute these commands.
	70	.SH SEE ALSO
	71	\fIcancel(1)\fR, \fIcupsenable(8)\fR, \fIlp(1)\fR,
	72	\fIlpadmin(8)\fR, \fIlpstat(1)\fR,
	73	.br
	74	http://localhost:631/help
	75	.SH COPYRIGHT
	76	Copyright 2007-2013 by Apple Inc.
	77	.\"
	78	.\" End of "$Id$".
	79	.\"