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

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