|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" cupsenable/cupsdisable man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2014 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH cupsenable 8 "CUPS" "11 June 2014" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
cupsdisable, cupsenable \- stop/start printers and classes
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B cupsdisable
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
.I reason
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-\-hold
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.I destination(s)
|
|
Packit |
2fc92b |
.br
|
|
Packit |
2fc92b |
.B cupsenable
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-\-release
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.I destination(s)
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
.B cupsenable
|
|
Packit |
2fc92b |
starts the named printers or classes while
|
|
Packit |
2fc92b |
.B cupsdisable
|
|
Packit |
2fc92b |
stops the named printers or classes.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
The following options may be used:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
Forces encryption of the connection to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-U \fIusername\fR
|
|
Packit |
2fc92b |
Uses the specified username when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
Cancels all jobs on the named destination.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
Uses the specified server and port.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-hold
|
|
Packit |
2fc92b |
Holds remaining jobs on the named printer.
|
|
Packit |
2fc92b |
Useful for allowing the current job to complete before performing maintenance.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-r "\fIreason\fB"\fR
|
|
Packit |
2fc92b |
Sets the message associated with the stopped state.
|
|
Packit |
2fc92b |
If no reason is specified then the message is set to "Reason Unknown".
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-release
|
|
Packit |
2fc92b |
Releases pending jobs for printing.
|
|
Packit |
2fc92b |
Use after running \fBcupsdisable\fR with the \fI\-\-hold\fR option to resume printing.
|
|
Packit |
2fc92b |
.SH CONFORMING TO
|
|
Packit |
2fc92b |
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#".
|
|
Packit |
2fc92b |
Also, printer and class names are \fInot\fR case-sensitive.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The System V versions of these commands are \fBdisable\fR and \fBenable\fR, respectively.
|
|
Packit |
2fc92b |
They have been renamed to avoid conflicts with the
|
|
Packit |
2fc92b |
.BR bash (1)
|
|
Packit |
2fc92b |
build-in commands of the same names.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The CUPS versions of \fBdisable\fR and \fBenable\fR may ask the user for an access password depending on the printing system configuration.
|
|
Packit |
2fc92b |
This differs from the System V versions which require the root user to execute these commands.
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cupsaccept (8),
|
|
Packit |
2fc92b |
.BR cupsreject (8),
|
|
Packit |
2fc92b |
.BR cancel (1),
|
|
Packit |
2fc92b |
.BR lp (1),
|
|
Packit |
2fc92b |
.BR lpadmin (8),
|
|
Packit |
2fc92b |
.BR lpstat (1),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|