LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

cupsdisable

stop printer from processing jobs

TLDR

Disable a printer
$ cupsdisable [printer_name]
copy
Disable with reason
$ cupsdisable -r "[maintenance]" [printer_name]
copy
Disable and cancel all jobs
$ cupsdisable -c [printer_name]
copy

SYNOPSIS

cupsdisable [-E] [-U user] [-c] [-h server[:port]] [-r reason] [--hold] destination...

DESCRIPTION

cupsdisable stops a CUPS printer or class from processing further jobs. By default, the in-progress job continues to print but new jobs queue up until the destination is re-enabled with cupsenable. With -c, all jobs are cancelled; with --hold, the current job finishes and remaining jobs are placed on hold (release them later with cupsenable --release).Requires CUPS administrator privileges (member of the lpadmin group or root).

PARAMETERS

-c

Cancel all jobs queued on the destination after disabling it.
-r reason
Reason message attached to the stopped state and reported by lpstat.
-E
Force encryption of the connection to the CUPS server.
-U user
Authenticate as user instead of the current login.
-h server[:port]
Connect to a specific CUPS server (default: $CUPS_SERVER, then localhost:631).
--hold
Hold all remaining queued jobs once the current one finishes — useful for performing maintenance after the in-flight job completes.

CAVEATS

In CUPS 1.5+ the same binary is also installed as cupsdisable for backwards compatibility with the historical Berkeley disable command — in fact the canonical name is cupsdisable. Some distributions ship it only under that name.

SEE ALSO

Copied to clipboard
Kai