1cupsenable(8)                    OpenPrinting                    cupsenable(8)
2
3
4

NAME

6       cupsdisable, cupsenable - stop/start printers and classes
7

SYNOPSIS

9       cupsdisable  [  -E  ]  [ -U username ] [ -c ] [ -h server[:port] ] [ -r
10       reason ] [ --hold ] destination(s)
11       cupsenable [ -E ] [ -U username ] [ -c ] [ -h server[:port] ]  [  --re‐
12       lease ] destination(s)
13

DESCRIPTION

15       cupsenable starts the named printers or classes while cupsdisable stops
16       the named printers or classes.
17

OPTIONS

19       The following options may be used:
20
21       -E   Forces encryption of the connection to the server.
22
23       -U username
24            Uses the specified username when connecting to the server.
25
26       -c   Cancels all jobs on the named destination.
27
28       -h server[:port]
29            Uses the specified server and port.
30
31       --hold
32            Holds remaining jobs on the named printer.   Useful  for  allowing
33            the current job to complete before performing maintenance.
34
35       -r "reason"
36            Sets  the message associated with the stopped state.  If no reason
37            is specified then the message is set to "Reason Unknown".
38
39       --release
40            Releases pending jobs for printing.  Use after running cupsdisable
41            with the --hold option to resume printing.
42

CONFORMING TO

44       Unlike  the System V printing system, CUPS allows printer names to con‐
45       tain any printable character except SPACE, TAB,  "/",  or  "#".   Also,
46       printer and class names are not case-sensitive.
47
48       The System V versions of these commands are disable and enable, respec‐
49       tively.  They have been renamed to avoid  conflicts  with  the  bash(1)
50       built-in commands of the same names.
51
52       The  CUPS versions of disable and enable may ask the user for an access
53       password depending on the printing system configuration.  This  differs
54       from the System V versions which require the root user to execute these
55       commands.
56

SEE ALSO

58       cupsaccept(8), cupsreject(8), cancel(1), lp(1), lpadmin(8),  lpstat(1),
59       CUPS Online Help (http://localhost:631/help)
60

62       Copyright © 2021-2023 by OpenPrinting.
63
64
65
662021-02-28                           CUPS                        cupsenable(8)
Impressum