]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cupsenable.html
The ipptool program now supports EXPECT statements for collection member
[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:
2909c66c
MS
32<dl class="man">
33<dt>-E
34<dd style="margin-left: 5.0em"><br>
c277f98c 35Forces encryption of the connection to the server.
2909c66c
MS
36<dt>-U username
37<dd style="margin-left: 5.0em"><br>
c277f98c 38Uses the specified username when connecting to the server.
2909c66c
MS
39<dt>-c
40<dd style="margin-left: 5.0em"><br>
c277f98c 41Cancels all jobs on the named destination.
2909c66c
MS
42<dt>-h server[:port]
43<dd style="margin-left: 5.0em"><br>
c277f98c 44Uses the specified server and port.
2909c66c
MS
45<dt>--hold
46<dd style="margin-left: 5.0em"><br>
c277f98c 47Holds remaining jobs on the named printer. Useful for allowing the current
94436c5a 48job to complete before performing maintenance.
2909c66c
MS
49<dt>-r "reason"
50<dd style="margin-left: 5.0em"><br>
c277f98c 51Sets the message associated with the stopped state. If no reason is specified
94436c5a 52then the message is set to "Reason Unknown".
2909c66c
MS
53<dt>--release
54<dd style="margin-left: 5.0em"><br>
c277f98c 55Releases pending jobs for printing. Use after running <i>cupsdisable</i> with
94436c5a 56the <i>--hold</i> option to resume printing.
2909c66c 57</dl>
94436c5a
MS
58<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
59Unlike the System V printing system, CUPS allows printer names to
60contain any printable character except SPACE, TAB, "/", or "#".
61Also, printer and class names are <i>not</i> case-sensitive.
62<p>The System V versions of these commands are <i>disable</i> and
63<i>enable</i>. They have been renamed to avoid conflicts with the
64<i>bash(1)</i> build-in commands of the same name.
65<p>The CUPS versions of <i>disable</i> and <i>enable</i> may ask the
66user for an access password depending on the printing system
67configuration. This differs from the System V versions which
68require the root user to execute these commands.
69<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c
MS
70<i>cupsaccept(8)</i>, <i>cupsreject(8)</i>, <i>cancel(1)</i>, <i>lp(1)</i>,
71<i>lpadmin(8)</i>, <i>lpstat(1)</i>,
94436c5a 72<br>
c277f98c 73<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
74<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
75Copyright 2007-2013 by Apple Inc.
76
77
78</body>
79</html>