cupsd

cups scheduler

TLDR

Start cupsd in the background, aka. as a daemon

$ cupsd

Start cupsd on the [f]oreground

$ cupsd -f

[l]aunch cupsd on-demand (commonly used by launchd or systemd)

$ cupsd -l

Start cupsd using the specified [c]upsd.conf configuration file

$ cupsd -c [path/to/cupsd.conf]

Start cupsd using the specified cups-file[s].conf configuration file

$ cupsd -s [path/to/cups-files.conf]

[t]est the [c]upsd.conf configuration file for errors

$ cupsd -t -c [path/to/cupsd.conf]

[t]est the cups-file[s].conf configuration file for errors

$ cupsd -t -s [path/to/cups-files.conf]

Display all available options

$ cupsd -h

SYNOPSIS

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

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

CONFORMING TO

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

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