1<!DOCTYPE HTML>
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>
11cupsdisable, cupsenable - stop/start printers and classes
12<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
13<b>cupsdisable</b>
14[
15<b>-E</b>
16] [
17<b>-U</b>
18<i>username</i>
19] [
20<b>-c</b>
21] [
22<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
23] [
24<b>-r</b>
25<i>reason</i>
26] [
27<b>--hold</b>
28]
29<i>destination(s)</i>
30<br>
31<b>cupsenable</b>
32[
33<b>-E</b>
34] [
35<b>-U</b>
36<i>username</i>
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>
45<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
46<b>cupsenable</b>
47starts the named printers or classes while
48<b>cupsdisable</b>
49stops the named printers or classes.
50<h2 class="title"><a name="OPTIONS">Options</a></h2>
51The following options may be used:
52<dl class="man">
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.
63Useful 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.
66If 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.
69Use after running <b>cupsdisable</b> with the <i>--hold</i> option to resume printing.
70</dl>
71<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
72Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
73Also, printer and class names are <i>not</i> case-sensitive.
74<p>The System V versions of these commands are <b>disable</b> and <b>enable</b>, respectively.
75They have been renamed to avoid conflicts with the
76<b>bash</b>(1)
77build-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.
79This differs from the System V versions which require the root user to execute these commands.
80<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
81<b>cupsaccept</b>(8),
82<b>cupsreject</b>(8),
83<b>cancel</b>(1),
84<b>lp</b>(1),
85<b>lpadmin</b>(8),
86<b>lpstat</b>(1),
87CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
88<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
89Copyright &copy; 2007-2019 by Apple Inc.
90
91</body>
92</html>
93