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

.\"
.\" accept/reject man page for CUPS.
.\"
.\" Copyright 2007-2014 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more information.
.\"
.TH cupsaccept 8 "CUPS" "10 June 2014" "Apple Inc."
.SH NAME
cupsaccept/cupsreject \- accept/reject jobs sent to a destination
.SH SYNOPSIS
.B cupsaccept
[
.B \-E
] [
.B \-U
.I username
] [
.B \-h
.I hostname[:port]
]
.I destination(s)
.br
.B cupsreject
[
.B \-E
] [
.B \-U
.I username
] [
.B \-h
.I hostname[:port]
] [
.B \-r
.I reason
]
.I destination(s)
.SH DESCRIPTION
The
.B cupsaccept
command instructs the printing system to accept print jobs to the specified destinations.
.LP
The
.B cupsreject
command 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
.B cupsaccept
and
.BR cupsreject :
.TP 5
.B \-E
Forces encryption when connecting to the server.
.TP 5
\fB-U \fIusername\fR
Sets the username that is sent when connecting to the server.
.TP 5
\fB-h \fIhostname[:port]\fR
Chooses an alternate server.
.TP 5
\fB-r \fR"\fIreason\fR"
Sets the reason string that is shown for a printer that is rejecting jobs.
.SH CONFORMING TO
The
.B cupsaccept
and
.B cupsreject
commands correspond to the System V printing system commands "accept" and "reject", respectively.
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
Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
.SH SEE ALSO
.BR cancel (1),
.BR cupsenable (8),
.BR lp (1),
.BR lpadmin (8),
.BR lpstat (1),
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2007-2018 by Apple Inc.
Commit	Line	Data
	1	.\"
	2	.\" accept/reject man page for CUPS.
	3	.\"
	4	.\" Copyright 2007-2014 by Apple Inc.
	5	.\" Copyright 1997-2006 by Easy Software Products.
	6	.\"
	7	.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
	8	.\"
	9	.TH cupsaccept 8 "CUPS" "10 June 2014" "Apple Inc."
	10	.SH NAME
	11	cupsaccept/cupsreject \- accept/reject jobs sent to a destination
	12	.SH SYNOPSIS
	13	.B cupsaccept
	14	[
	15	.B \-E
	16	] [
	17	.B \-U
	18	.I username
	19	] [
	20	.B \-h
	21	.I hostname[:port]
	22	]
	23	.I destination(s)
	24	.br
	25	.B cupsreject
	26	[
	27	.B \-E
	28	] [
	29	.B \-U
	30	.I username
	31	] [
	32	.B \-h
	33	.I hostname[:port]
	34	] [
	35	.B \-r
	36	.I reason
	37	]
	38	.I destination(s)
	39	.SH DESCRIPTION
	40	The
	41	.B cupsaccept
	42	command instructs the printing system to accept print jobs to the specified destinations.
	43	.LP
	44	The
	45	.B cupsreject
	46	command instructs the printing system to reject print jobs to the
	47	specified destinations.
	48	The \fI-r\fR option sets the reason for rejecting print jobs. If not specified, the reason defaults to "Reason Unknown".
	49	.SH OPTIONS
	50	The following options are supported by both
	51	.B cupsaccept
	52	and
	53	.BR cupsreject :
	54	.TP 5
	55	.B \-E
	56	Forces encryption when connecting to the server.
	57	.TP 5
	58	\fB-U \fIusername\fR
	59	Sets the username that is sent when connecting to the server.
	60	.TP 5
	61	\fB-h \fIhostname[:port]\fR
	62	Chooses an alternate server.
	63	.TP 5
	64	\fB-r \fR"\fIreason\fR"
	65	Sets the reason string that is shown for a printer that is rejecting jobs.
	66	.SH CONFORMING TO
	67	The
	68	.B cupsaccept
	69	and
	70	.B cupsreject
	71	commands correspond to the System V printing system commands "accept" and "reject", respectively.
	72	Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
	73	Also, printer and class names are \fInot\fR case-sensitive.
	74	.LP
	75	Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
	76	.SH SEE ALSO
	77	.BR cancel (1),
	78	.BR cupsenable (8),
	79	.BR lp (1),
	80	.BR lpadmin (8),
	81	.BR lpstat (1),
	82	.br
	83	CUPS Online Help (http://localhost:631/help)
	84	.SH COPYRIGHT
	85	Copyright \[co] 2007-2018 by Apple Inc.