cups
Manage printing and print queues
TLDR
View documentation for running the CUPS daemon
View documentation for managing printers
View documentation for printing files
View documentation for checking status information about the current classes, jobs, and printers
View documentation for cancelling print jobs
SYNOPSIS
No single "cups" command; use lp [-d dest] [-n copies] [files] | lpadmin [-p printer] [options] | cupsd [-f]
PARAMETERS
-d dest
Set destination printer (lp)
-n num
Number of copies (lp)
-p name
Printer name (lpadmin)
-E
Use encryption/force (many CUPS cmds)
-h host[:port]
Remote server (admin cmds)
DESCRIPTION
The CUPS (Common UNIX Printing System) is the de facto standard for printing on Linux and Unix-like systems. It provides a complete printing solution including a printing daemon (cupsd), client commands for submitting and managing jobs, and server-side administration tools. There is no standalone cups executable; instead, CUPS functionality is accessed via dedicated commands like lp (print files), lpstat (display status), lpadmin (add/modify printers), lpq/lprm (queue management), and cupsd (daemon).
CUPS supports IPP (Internet Printing Protocol), USB/local printers, network discovery, PDF/PostScript rendering, and driverless printing. Configuration is via /etc/cups/cupsd.conf, with web interface at http://localhost:631. It unifies System V and BSD print commands, making it portable across distros. Developers use cups-config for compile flags. CUPS replaced LPD and is managed via systemd (systemctl).
CAVEATS
No standard "cups" command exists; refers to CUPS suite. Install via cups package. Root often required for admin. Web UI needs authentication. Deprecated filters in modern versions.
WEB INTERFACE
Access http://localhost:631 for GUI management of printers/jobs without CLI.
COMMON USAGE
lpstat -p (list printers), lp /etc/passwd (print file), cancel -a (clear queues).
HISTORY
Developed 1999 by Michael Sweet at Easy Software Products. Adopted by Apple for macOS. Version 2.0 (2013) added driverless printing. Now maintained by OpenPrinting.org after ESP dissolution.
SEE ALSO
lp(1), lpr(1), lpadmin(8), lpstat(1), cupsd(8), cups-config(8), cupsdisable(8)


