]>
Commit | Line | Data |
---|---|---|
c277f98c | 1 | <!DOCTYPE HTML> |
94436c5a MS |
2 | <html> |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>cupsenable(8)</title> | |
7 | </head> | |
8 | <body> | |
9 | <h1 class="title">cupsenable(8)</h1> | |
10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
11 | cupsdisable, cupsenable - stop/start printers and classes | |
12 | <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2> | |
c277f98c | 13 | <b>cupsdisable</b> |
bf1bc4c6 MS |
14 | [ |
15 | <b>-E</b> | |
16 | ] [ | |
17 | <b>-U</b> | |
c277f98c | 18 | <i>username</i> |
bf1bc4c6 MS |
19 | ] [ |
20 | <b>-c</b> | |
21 | ] [ | |
22 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
23 | ] [ | |
24 | <b>-r</b> | |
c277f98c | 25 | <i>reason</i> |
bf1bc4c6 MS |
26 | ] [ |
27 | <b>--hold</b> | |
28 | ] | |
29 | <i>destination(s)</i> | |
c277f98c MS |
30 | <br> |
31 | <b>cupsenable</b> | |
bf1bc4c6 MS |
32 | [ |
33 | <b>-E</b> | |
34 | ] [ | |
35 | <b>-U</b> | |
c277f98c | 36 | <i>username</i> |
bf1bc4c6 MS |
37 | ] [ |
38 | <b>-c</b> | |
39 | ] [ | |
40 | <b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
41 | ] [ | |
42 | <b>--release</b> | |
43 | ] | |
44 | <i>destination(s)</i> | |
94436c5a | 45 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
bf1bc4c6 MS |
46 | <b>cupsenable</b> |
47 | starts the named printers or classes while | |
48 | <b>cupsdisable</b> | |
49 | stops the named printers or classes. | |
50 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
51 | The following options may be used: | |
2909c66c | 52 | <dl class="man"> |
bf1bc4c6 MS |
53 | <dt><b>-E</b> |
54 | <dd style="margin-left: 5.0em">Forces encryption of the connection to the server. | |
55 | <dt><b>-U </b><i>username</i> | |
56 | <dd style="margin-left: 5.0em">Uses the specified username when connecting to the server. | |
57 | <dt><b>-c</b> | |
58 | <dd style="margin-left: 5.0em">Cancels all jobs on the named destination. | |
59 | <dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>] | |
60 | <dd style="margin-left: 5.0em">Uses the specified server and port. | |
61 | <dt><b>--hold</b> | |
62 | <dd style="margin-left: 5.0em">Holds remaining jobs on the named printer. | |
63 | Useful for allowing the current job to complete before performing maintenance. | |
64 | <dt><b>-r "</b><i>reason</i><b>"</b> | |
65 | <dd style="margin-left: 5.0em">Sets the message associated with the stopped state. | |
66 | If no reason is specified then the message is set to "Reason Unknown". | |
67 | <dt><b>--release</b> | |
68 | <dd style="margin-left: 5.0em">Releases pending jobs for printing. | |
69 | Use after running <b>cupsdisable</b> with the <i>--hold</i> option to resume printing. | |
2909c66c | 70 | </dl> |
bf1bc4c6 MS |
71 | <h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2> |
72 | Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". | |
94436c5a | 73 | Also, printer and class names are <i>not</i> case-sensitive. |
bf1bc4c6 MS |
74 | <p>The System V versions of these commands are <b>disable</b> and <b>enable</b>, respectively. |
75 | They have been renamed to avoid conflicts with the | |
76 | <b>bash</b>(1) | |
77 | build-in commands of the same names. | |
78 | <p>The CUPS versions of <b>disable</b> and <b>enable</b> may ask the user for an access password depending on the printing system configuration. | |
79 | This differs from the System V versions which require the root user to execute these commands. | |
94436c5a | 80 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> |
bf1bc4c6 MS |
81 | <a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a> |
82 | <b>cupsreject</b>(8), | |
83 | <a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a> | |
84 | <a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a> | |
85 | <a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a> | |
86 | <a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a> | |
87 | CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) | |
94436c5a | 88 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
bd5a2f28 | 89 | Copyright © 2007-2017 by Apple Inc. |
94436c5a | 90 | |
94436c5a MS |
91 | </body> |
92 | </html> |