projects / thirdparty / cups.git / blame
| 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 |
| bd5a2f28 | 96 | Copyright \[co] 2007-2017 by Apple Inc. |