]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
bf1bc4c6 | 2 | .\" cupsenable/cupsdisable man page for CUPS. |
ef416fc2 | 3 | .\" |
bf1bc4c6 MS |
4 | .\" Copyright 2007-2014 by Apple Inc. |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
ef416fc2 | 6 | .\" |
e3101897 | 7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. |
ef416fc2 | 8 | .\" |
bf1bc4c6 | 9 | .TH cupsenable 8 "CUPS" "11 June 2014" "Apple Inc." |
ef416fc2 | 10 | .SH NAME |
bd7854cb | 11 | cupsdisable, cupsenable \- stop/start printers and classes |
ef416fc2 | 12 | .SH SYNOPSIS |
bd7854cb | 13 | .B cupsdisable |
bf1bc4c6 MS |
14 | [ |
15 | .B \-E | |
16 | ] [ | |
17 | .B \-U | |
bd7854cb | 18 | .I username |
bf1bc4c6 MS |
19 | ] [ |
20 | .B \-c | |
21 | ] [ | |
22 | \fB\-h \fIserver\fR[\fB:\fIport\fR] | |
23 | ] [ | |
24 | .B \-r | |
ef416fc2 | 25 | .I reason |
bf1bc4c6 MS |
26 | ] [ |
27 | .B \-\-hold | |
28 | ] | |
29 | .I destination(s) | |
ef416fc2 | 30 | .br |
bd7854cb | 31 | .B cupsenable |
bf1bc4c6 MS |
32 | [ |
33 | .B \-E | |
34 | ] [ | |
35 | .B \-U | |
bd7854cb | 36 | .I username |
bf1bc4c6 MS |
37 | ] [ |
38 | .B \-c | |
39 | ] [ | |
40 | \fB\-h \fIserver\fR[\fB:\fIport\fR] | |
41 | ] [ | |
42 | .B \-\-release | |
43 | ] | |
44 | .I destination(s) | |
ef416fc2 | 45 | .SH DESCRIPTION |
bf1bc4c6 MS |
46 | .B cupsenable |
47 | starts the named printers or classes while | |
48 | .B cupsdisable | |
49 | stops the named printers or classes. | |
50 | .SH OPTIONS | |
51 | The following options may be used: | |
bd7854cb | 52 | .TP 5 |
bf1bc4c6 | 53 | .B \-E |
bd7854cb | 54 | Forces encryption of the connection to the server. |
ef416fc2 | 55 | .TP 5 |
bf1bc4c6 | 56 | \fB\-U \fIusername\fR |
bd7854cb | 57 | Uses the specified username when connecting to the server. |
58 | .TP 5 | |
bf1bc4c6 | 59 | .B \-c |
ef416fc2 | 60 | Cancels all jobs on the named destination. |
61 | .TP 5 | |
bf1bc4c6 | 62 | \fB\-h \fIserver\fR[\fB:\fIport\fR] |
bd7854cb | 63 | Uses the specified server and port. |
64 | .TP 5 | |
bf1bc4c6 MS |
65 | .B \-\-hold |
66 | Holds remaining jobs on the named printer. | |
67 | Useful for allowing the current job to complete before performing maintenance. | |
61cf44e2 | 68 | .TP 5 |
bf1bc4c6 MS |
69 | \fB\-r "\fIreason\fB"\fR |
70 | Sets the message associated with the stopped state. | |
71 | If no reason is specified then the message is set to "Reason Unknown". | |
61cf44e2 | 72 | .TP 5 |
bf1bc4c6 MS |
73 | .B \-\-release |
74 | Releases pending jobs for printing. | |
75 | Use after running \fBcupsdisable\fR with the \fI\-\-hold\fR option to resume printing. | |
76 | .SH CONFORMING TO | |
77 | Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". | |
bd7854cb | 78 | Also, printer and class names are \fInot\fR case-sensitive. |
79 | .LP | |
bf1bc4c6 MS |
80 | The System V versions of these commands are \fBdisable\fR and \fBenable\fR, respectively. |
81 | They have been renamed to avoid conflicts with the | |
82 | .BR bash (1) | |
83 | build-in commands of the same names. | |
bd7854cb | 84 | .LP |
bf1bc4c6 MS |
85 | The CUPS versions of \fBdisable\fR and \fBenable\fR may ask the user for an access password depending on the printing system configuration. |
86 | This differs from the System V versions which require the root user to execute these commands. | |
ef416fc2 | 87 | .SH SEE ALSO |
bf1bc4c6 MS |
88 | .BR cupsaccept (8), |
89 | .BR cupsreject (8), | |
90 | .BR cancel (1), | |
91 | .BR lp (1), | |
92 | .BR lpadmin (8), | |
93 | .BR lpstat (1), | |
94 | CUPS Online Help (http://localhost:631/help) | |
ef416fc2 | 95 | .SH COPYRIGHT |
f61dfc0d | 96 | Copyright \[co] 2007-2018 by Apple Inc. |