cupsd(8)

💖 cupsd(8) — the OpenPrinting era, bestie 💖

okay so like. this is cupsd, the CUPS scheduler, and she's the whole reason your printer situation is even functioning rn. let's get into it ✨

---

🌸 NAME 🌸

cupsd — the cups scheduler 👑

---

🎀 SYNOPSIS 🎀

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

---

✨ DESCRIPTION ✨

cupsd is the scheduler for CUPS. she literally is the printing system, no cap. she implements a printing system based upon the Internet Printing Protocol, version 2.1, and supports most of the requirements for IPP Everywhere. main character energy fr 💅

and if you don't pass any options on the command-line at all? she just uses the default config file /etc/cups/cupsd.conf. she's chill like that. 🦋

---

💅 OPTIONS 💅

• -c cupsd.conf — uses the named cupsd.conf configuration file. your config, your rules, periodt.
• -f — run cupsd in the foreground. the default is to run in the background as a "daemon". (not her hiding from you, just daemon things 🙈)
• -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). lowkey the glow-up version of -f.
• -h — shows the program usage. the "help me bestie" button 🫶
• -l — this option is passed to cupsd when it is run from launchd(8) or systemd(8). it's giving "the system made me do it".
• -s cups-files.conf — uses the named cups-files.conf configuration file.
• -t — test the configuration file for syntax errors. vibe check but for your config 🌈

---

🗂️ 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. she also implements several CUPS-specific administrative operations — overachiever behavior, honestly, and we love her for it 💜

---

🧚 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

---

🦋 SEE ALSO 🦋

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 ⭐

Copyright © 2020-2024 by OpenPrinting.

---

not me ending this whole thing with the receipts: this page came from CUPS, dated 2021-02-28, and yeah the manual name up top was cupsd(8) the whole time 💖 periodt, go print something gorgeous, bestie 🎀🌸✨