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