cupsd - Man Page

• 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 help: cupsd -h

tldr.sh

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.

-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.

/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

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

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

backend(7), classes.conf(5), cups(1), cups-files.conf(5), cups-lpd(8), cupsd.conf(5), cupsd-helper(8), cupsd-logs(8), filter(7), launchd(8), mime.convs(5), mime.types(5), printers.conf(5), systemd(8), CUPS Online Help (http://localhost:631/help)

Copyright © 2020-2024 by OpenPrinting.

backend(7), classes.conf(5), cups(1), cupsctl(8), cupsd.conf(5), cupsd-helper(8), cupsd-logs(5), cupsd_selinux(8), cups-files.conf(5), cups-lpd(8), cups-snmp(8), filter(7), mailto.conf(5), mime.convs(5), mime.types(5), notifier(7), printers.conf(5), subscriptions.conf(5).