cupsdisable
stop printer from processing jobs
TLDR
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
cupsenable(1), cupsaccept(1), cupsreject(1)
