Update .gitignore to ignore compressed man pages.
[thirdparty/cups.git] / man / cupsaccept.man
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.