.\"
-.\" "$Id: cupsenable.man 4833 2005-11-12 21:46:52Z mike $"
+.\" cupsenable/cupsdisable man page for CUPS.
.\"
-.\" enable/disable man page for the Common UNIX Printing System (CUPS).
+.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 1997-2006 by Easy Software Products.
.\"
-.\" Copyright 1997-2005 by Easy Software Products.
+.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
.\"
-.\" These coded instructions, statements, and computer programs are the
-.\" property of Easy Software Products and are protected by Federal
-.\" copyright law. Distribution and use rights are outlined in the file
-.\" "LICENSE.txt" which should have been included with this file. If this
-.\" file is missing or damaged please contact Easy Software Products
-.\" at:
-.\"
-.\" Attn: CUPS Licensing Information
-.\" Easy Software Products
-.\" 44141 Airport View Drive, Suite 204
-.\" Hollywood, Maryland 20636 USA
-.\"
-.\" Voice: (301) 373-9600
-.\" EMail: cups-info@cups.org
-.\" WWW: http://www.cups.org
-.\"
-.TH enable 8 "Common UNIX Printing System" "23 January 2001" "Easy Software Products"
+.TH cupsenable 8 "CUPS" "11 June 2014" "Apple Inc."
.SH NAME
-disable, enable \- stop/start printers and classes
+cupsdisable, cupsenable \- stop/start printers and classes
.SH SYNOPSIS
-.B disable
-[ -E ] [ \-c ] [ -h
-.I server
-] [ \-r
+.B cupsdisable
+[
+.B \-E
+] [
+.B \-U
+.I username
+] [
+.B \-c
+] [
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
+] [
+.B \-r
.I reason
-] destination(s)
+] [
+.B \-\-hold
+]
+.I destination(s)
.br
-.B enable
-[ -E ] destination(s)
+.B cupsenable
+[
+.B \-E
+] [
+.B \-U
+.I username
+] [
+.B \-c
+] [
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
+] [
+.B \-\-release
+]
+.I destination(s)
.SH DESCRIPTION
-\fIenable\fR starts the named printers or classes.
-.LP
-\fIdisable\fR stops the named printers or classes. The following options may
-be used:
+.B cupsenable
+starts the named printers or classes while
+.B cupsdisable
+stops the named printers or classes.
+.SH OPTIONS
+The following options may be used:
.TP 5
-\-c
-.br
+.B \-E
+Forces encryption of the connection to the server.
+.TP 5
+\fB\-U \fIusername\fR
+Uses the specified username when connecting to the server.
+.TP 5
+.B \-c
Cancels all jobs on the named destination.
.TP 5
-\-r [ \fIreason\fR ]
-.br
-Sets the message associated with the stopped state. If no reason is specified
-then the message is set to "Reason Unknown".
+\fB\-h \fIserver\fR[\fB:\fIport\fR]
+Uses the specified server and port.
+.TP 5
+.B \-\-hold
+Holds remaining jobs on the named printer.
+Useful for allowing the current job to complete before performing maintenance.
+.TP 5
+\fB\-r "\fIreason\fB"\fR
+Sets the message associated with the stopped state.
+If no reason is specified then the message is set to "Reason Unknown".
+.TP 5
+.B \-\-release
+Releases pending jobs for printing.
+Use after running \fBcupsdisable\fR with the \fI\-\-hold\fR option to resume printing.
+.SH CONFORMING TO
+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 \fInot\fR case-sensitive.
.LP
-The \fI-E\fR option forces encryption when connecting to the server.
-.SH COMPATIBILITY
-The CUPS versions of \fIdisable\fR and \fIenable\fR 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.
+The System V versions of these commands are \fBdisable\fR and \fBenable\fR, respectively.
+They have been renamed to avoid conflicts with the
+.BR bash (1)
+build-in commands of the same names.
+.LP
+The CUPS versions of \fBdisable\fR and \fBenable\fR 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.
.SH SEE ALSO
-accept(8), cancel(1), lp(1), lpadmin(8), lpstat(1), reject(8),
-CUPS Software Administrators Manual,
-http://localhost:631/documentation.html
+.BR cupsaccept (8),
+.BR cupsreject (8),
+.BR cancel (1),
+.BR lp (1),
+.BR lpadmin (8),
+.BR lpstat (1),
+CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright 1993-2005 by Easy Software Products, All Rights Reserved.
-
-.\"
-.\" End of "$Id: cupsenable.man 4833 2005-11-12 21:46:52Z mike $".
-.\"
+Copyright \[co] 2007-2018 by Apple Inc.
projects / thirdparty / cups.git / blobdiff