cupsctl(8)

💅 cupsctl — configure cupsd.conf options

okay bestie, welcome to cupsctl, the lil command from the OpenPrinting CUPS era that lets you poke at your server's cupsd.conf without, like, opening the file and having a whole crisis. it lives in section 8 of the manual, so yeah, it's a system-admin girlie. 👑

---

✨ SYNOPSIS ✨

cupsctl [ -h server[:port] ] [ -E ] [ -U username ] [
--[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ] [
--[no-]share-printers ] [ --[no-]user-cancel-any ] [ name=value ]

---

🌸 DESCRIPTION 🌸

so here's the tea: cupsctl updates or queries the cupsd.conf file for a server. that's it, that's the job. 🫶

and if you ask for no changes at all? it just reads back the current configuration values and writes them to standard output, formatted as "name=value", one per line. it's giving "let me check the vibe before I touch anything." 💖

---

🎀 OPTIONS 🎀

these are the flags we recognize, no more no less:

• -E — turns on encryption for the connection to the scheduler. secure girlie behavior. 🔒
• -U username — lets you pick an alternate username to use when authenticating with the scheduler.
• -h server[:port] — specifies the server address.

⚠️ note: this option must occur before all others. it's the main character, it goes first, periodt.

• --[no-]debug-logging — enables (or disables) debug logging to the error_log file. 🔍
• --[no-]remote-admin — enables (or disables) remote administration.
• --[no-]remote-any — enables (or disables) printing from any address, like, e.g., the Internet. 🌐
• --[no-]share-printers — enables (or disables) sharing of local printers with other computers.
• --[no-]user-cancel-any — allows (or prevents) users to cancel jobs owned by others. bestie said "I'll cancel your print job and I won't apologize." 💀

---

🌈 EXAMPLES 🌈

display the current settings:

cupsctl

enable debug logging:

cupsctl --debug-logging

get the current debug logging state:

cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'

disable printer sharing:

cupsctl --no-share-printers

---

😭 KNOWN ISSUES 😭

you cannot set the Listen or Port directives using cupsctl. nope. not happening. not today. 🙈

---

🦋 SEE ALSO 🦋

• cupsd.conf(5)
• cupsd(8)
• CUPS Online Help (http://localhost:631/help)

---

👑 COPYRIGHT 👑

Copyright © 2020-2024 by OpenPrinting.

---

and that's the whole page, bestie 💜 — brought to you by CUPS, dated 2022-05-02. go forth and configure responsibly, iykyk. ✨🌸