]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cupsenable.html
Initial work on man page modernization (STR #4372)
[thirdparty/cups.git] / doc / help / man-cupsenable.html
CommitLineData
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>
11cupsdisable, cupsenable - stop/start printers and classes
12<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c
MS
13<b>cupsdisable</b>
14[ -E ] [-U
15<i>username</i>
16] [ -c ] [ -h
17<i>server[:port]</i>
18] [ -r
19<i>reason</i>
20] [ --hold ] destination(s)
21<br>
22<b>cupsenable</b>
23[ -E ] [-U
24<i>username</i>
25] [ -c ] [ -h
26<i>server[:port]</i>
27] [ --release ] destination(s)
94436c5a
MS
28<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
29<i>cupsenable</i> starts the named printers or classes.
30<p><i>cupsdisable</i> stops the named printers or classes. The
31following options may be used:
c277f98c
MS
32<p style="margin-left: 5.0em; text-indent: -5.0em">-E
33<br>
34<br>
35Forces encryption of the connection to the server.
36<p style="margin-left: 5.0em; text-indent: -5.0em">-U username
37<br>
38<br>
39Uses the specified username when connecting to the server.
40<p style="margin-left: 5.0em; text-indent: -5.0em">-c
41<br>
42<br>
43Cancels all jobs on the named destination.
44<p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port]
45<br>
46<br>
47Uses the specified server and port.
48<p style="margin-left: 5.0em; text-indent: -5.0em">--hold
49<br>
50<br>
51Holds remaining jobs on the named printer. Useful for allowing the current
94436c5a 52job to complete before performing maintenance.
c277f98c
MS
53<p style="margin-left: 5.0em; text-indent: -5.0em">-r "reason"
54<br>
55<br>
56Sets the message associated with the stopped state. If no reason is specified
94436c5a 57then the message is set to "Reason Unknown".
c277f98c
MS
58<p style="margin-left: 5.0em; text-indent: -5.0em">--release
59<br>
60<br>
61Releases pending jobs for printing. Use after running <i>cupsdisable</i> with
94436c5a 62the <i>--hold</i> option to resume printing.
94436c5a
MS
63<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
64Unlike the System V printing system, CUPS allows printer names to
65contain any printable character except SPACE, TAB, "/", or "#".
66Also, printer and class names are <i>not</i> case-sensitive.
67<p>The System V versions of these commands are <i>disable</i> and
68<i>enable</i>. They have been renamed to avoid conflicts with the
69<i>bash(1)</i> build-in commands of the same name.
70<p>The CUPS versions of <i>disable</i> and <i>enable</i> may ask the
71user for an access password depending on the printing system
72configuration. This differs from the System V versions which
73require the root user to execute these commands.
74<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c
MS
75<i>cupsaccept(8)</i>, <i>cupsreject(8)</i>, <i>cancel(1)</i>, <i>lp(1)</i>,
76<i>lpadmin(8)</i>, <i>lpstat(1)</i>,
94436c5a 77<br>
c277f98c 78<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
79<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
80Copyright 2007-2013 by Apple Inc.
81
82
83</body>
84</html>