LinuxCommandLibrary

cups

Manage printing and print queues

TLDR

View documentation for running the CUPS daemon

$ tldr cupsd
copy

View documentation for managing printers
$ tldr lpadmin
copy

View documentation for printing files
$ tldr lp
copy

View documentation for checking status information about the current classes, jobs, and printers
$ tldr lpstat
copy

View documentation for cancelling print jobs
$ tldr lprm
copy

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)

Copied to clipboard