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<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> 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 © 2007-2014 by Apple Inc. 90 91 92</body> 93</html> 94