cupsd(8)

cupsd8

Cups scheduler

Usage

cupsd [-c cupsd.conf] [-f] [-F] [-h] [-l] [-s cups-files.conf] [-t]

Overview

cupsd is the scheduler for CUPS. It implements a printing system based upon the Internet Printing Protocol, version 2.1, and supports most of the requirements for IPP Everywhere. If no options are specified on the command-line then the default configuration file /etc/cups/cupsd.conf will be used.

Options

-c cupsd.conf

Uses the named cupsd.conf configuration file.

-f

Run cupsd in the foreground; the default is to run in the background as a "daemon".

-F

Run cupsd in the foreground but detach the process from the controlling terminal and current directory. This is useful for running cupsd from init(8).

-h

Shows the program usage.

-l

This option is passed to cupsd when it is run from launchd(8) or systemd(8).

-s cups-files.conf

Uses the named cups-files.conf configuration file.

-t

Test the configuration file for syntax errors.

Files

/etc/cups/classes.conf
/etc/cups/cups-files.conf
/etc/cups/cupsd.conf
/usr/share/cups/mime/mime.convs
/usr/share/cups/mime/mime.types
/etc/cups/printers.conf
/etc/cups/subscriptions.conf

Examples

Run cupsd in the background with the default configuration file:

    cupsd

Test a configuration file called test.conf:

    cupsd -t -c test.conf

Run cupsd in the foreground with a test configuration file called test.conf:

    cupsd -f -c test.conf

Releases

14 releases since Debian 2.2 (Potato); the text changed 12 times.

  1. 2.2
  2. 3.0
  3. 3.1
  4. 4.0
  5. 5.0
  6. 6.0
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13–Arch

-F since Debian 4.0 (Etch); -f since Debian 4.0 (Etch); -h since Debian 4.0 (Etch); -l since Debian 4.0 (Etch); -t since Debian 6.0 (Squeeze).

-c until Debian 8 (Jessie).

Conforming to

cupsd implements all of the required IPP/2.1 attributes and operations. It also implements several CUPS-specific administrative operations.

From cups 2:2.4.20-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.