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