[thirdparty/cups.git] / doc / help / man-cupsenable.html

<!DOCTYPE HTML>
<html>
<!-- SECTION: Man Pages -->
<head>
	<link rel="stylesheet" type="text/css" href="../cups-printable.css">
	<title>cupsenable(8)</title>
</head>
<body>
<h1 class="title">cupsenable(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsdisable, cupsenable - stop/start printers and classes
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsdisable</b>
[
<b>-E</b>
] [
<b>-U</b>
<i>username</i>
] [
<b>-c</b>
] [
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
] [
<b>-r</b>
<i>reason</i>
] [
<b>--hold</b>
]
<i>destination(s)</i>
<br>
<b>cupsenable</b>
[
<b>-E</b>
] [
<b>-U</b>
<i>username</i>
] [
<b>-c</b>
] [
<b>-h </b><i>server</i>[<b>:</b><i>port</i>]
] [
<b>--release</b>
]
<i>destination(s)</i>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<b>cupsenable</b>
starts the named printers or classes while
<b>cupsdisable</b>
stops the named printers or classes.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options may be used:
<dl class="man">
<dt><b>-E</b>
<dd style="margin-left: 5.0em">Forces encryption of the connection to the server.
<dt><b>-U </b><i>username</i>
<dd style="margin-left: 5.0em">Uses the specified username when connecting to the server.
<dt><b>-c</b>
<dd style="margin-left: 5.0em">Cancels all jobs on the named destination.
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
<dd style="margin-left: 5.0em">Uses the specified server and port.
<dt><b>--hold</b>
<dd style="margin-left: 5.0em">Holds remaining jobs on the named printer.
Useful for allowing the current job to complete before performing maintenance.
<dt><b>-r "</b><i>reason</i><b>"</b>
<dd style="margin-left: 5.0em">Sets the message associated with the stopped state.
If no reason is specified then the message is set to "Reason Unknown".
<dt><b>--release</b>
<dd style="margin-left: 5.0em">Releases pending jobs for printing.
Use after running <b>cupsdisable</b> with the <i>--hold</i> option to resume printing.
</dl>
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
Also, printer and class names are <i>not</i> case-sensitive.
<p>The System V versions of these commands are <b>disable</b> and <b>enable</b>, respectively.
They have been renamed to avoid conflicts with the
<b>bash</b>(1)
build-in commands of the same names.
<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.
This differs from the System V versions which require the root user to execute these commands.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<b>cupsaccept</b>(8),
<b>cupsreject</b>(8),
<b>cancel</b>(1),
<b>lp</b>(1),
<b>lpadmin</b>(8),
<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright &copy; 2007-2019 by Apple Inc.

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