]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | .\" |
e4e5666b | 2 | .\" "$Id$" |
ef416fc2 | 3 | .\" |
321d8d57 | 4 | .\" cupsenable/cupsdisable man page for CUPS. |
ef416fc2 | 5 | .\" |
0fa6c7fa | 6 | .\" Copyright 2007-2013 by Apple Inc. |
bd7854cb | 7 | .\" Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 8 | .\" |
9 | .\" These coded instructions, statements, and computer programs are the | |
bc44d920 | 10 | .\" property of Apple Inc. and are protected by Federal copyright |
11 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
12 | .\" which should have been included with this file. If this file is | |
13 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
ef416fc2 | 14 | .\" |
9aff70cc | 15 | .TH cupsenable 8 "CUPS" "9 October 2008" "Apple Inc." |
ef416fc2 | 16 | .SH NAME |
bd7854cb | 17 | cupsdisable, cupsenable \- stop/start printers and classes |
ef416fc2 | 18 | .SH SYNOPSIS |
bd7854cb | 19 | .B cupsdisable |
20 | [ -E ] [-U | |
21 | .I username | |
22 | ] [ -c ] [ -h | |
23 | .I server[:port] | |
24 | ] [ -r | |
ef416fc2 | 25 | .I reason |
61cf44e2 | 26 | ] [ --hold ] destination(s) |
ef416fc2 | 27 | .br |
bd7854cb | 28 | .B cupsenable |
29 | [ -E ] [-U | |
30 | .I username | |
31 | ] [ -c ] [ -h | |
32 | .I server[:port] | |
61cf44e2 | 33 | ] [ --release ] destination(s) |
ef416fc2 | 34 | .SH DESCRIPTION |
bd7854cb | 35 | \fIcupsenable\fR starts the named printers or classes. |
ef416fc2 | 36 | .LP |
bd7854cb | 37 | \fIcupsdisable\fR stops the named printers or classes. The |
38 | following options may be used: | |
39 | .TP 5 | |
40 | -E | |
41 | .br | |
42 | Forces encryption of the connection to the server. | |
ef416fc2 | 43 | .TP 5 |
bd7854cb | 44 | -U username |
45 | .br | |
46 | Uses the specified username when connecting to the server. | |
47 | .TP 5 | |
48 | -c | |
ef416fc2 | 49 | .br |
50 | Cancels all jobs on the named destination. | |
51 | .TP 5 | |
bd7854cb | 52 | -h server[:port] |
53 | .br | |
54 | Uses the specified server and port. | |
55 | .TP 5 | |
61cf44e2 MS |
56 | --hold |
57 | .br | |
58 | Holds remaining jobs on the named printer. Useful for allowing the current | |
59 | job to complete before performing maintenance. | |
60 | .TP 5 | |
bd7854cb | 61 | -r "reason" |
ef416fc2 | 62 | .br |
63 | Sets the message associated with the stopped state. If no reason is specified | |
64 | then the message is set to "Reason Unknown". | |
61cf44e2 MS |
65 | .TP 5 |
66 | --release | |
67 | .br | |
68 | Releases pending jobs for printing. Use after running \fIcupsdisable\fR with | |
69 | the \fI--hold\fR option to resume printing. | |
ef416fc2 | 70 | .SH COMPATIBILITY |
bd7854cb | 71 | Unlike the System V printing system, CUPS allows printer names to |
72 | contain any printable character except SPACE, TAB, "/", or "#". | |
73 | Also, printer and class names are \fInot\fR case-sensitive. | |
74 | .LP | |
75 | The System V versions of these commands are \fIdisable\fR and | |
76 | \fIenable\fR. They have been renamed to avoid conflicts with the | |
61cf44e2 | 77 | \fIbash(1)\fR build-in commands of the same name. |
bd7854cb | 78 | .LP |
79 | The CUPS versions of \fIdisable\fR and \fIenable\fR may ask the | |
80 | user for an access password depending on the printing system | |
81 | configuration. This differs from the System V versions which | |
82 | require the root user to execute these commands. | |
ef416fc2 | 83 | .SH SEE ALSO |
61cf44e2 MS |
84 | \fIcupsaccept(8)\fR, \fIcupsreject(8)\fR, \fIcancel(1)\fR, \fIlp(1)\fR, |
85 | \fIlpadmin(8)\fR, \fIlpstat(1)\fR, | |
bd7854cb | 86 | .br |
87 | http://localhost:631/help | |
ef416fc2 | 88 | .SH COPYRIGHT |
0fa6c7fa | 89 | Copyright 2007-2013 by Apple Inc. |
ef416fc2 | 90 | |
91 | .\" | |
e4e5666b | 92 | .\" End of "$Id$". |
ef416fc2 | 93 | .\" |