snmp.conf(5)

✨ snmp.conf — the snmp configuration file for cups (deprecated, bestie 😭) ✨

okay so this is snmp.conf, from section 5 of the manual (that's the "file formats" girlies 💅), and it's the snmp configuration file for cups. heads up tho — she's deprecated, so read the NOTES before you fall in love 🥲

---

💖 NAME 💖

snmp.conf — snmp configuration file for cups (deprecated, no cap)

---

🌸 DESCRIPTION 🌸

So the snmp.conf file is literally the vibe-setter for how the standard CUPS network backends — that's http, https, ipp, ipps, lpd, snmp, and socket — go get printer information using SNMPv1 🖨️✨

She normally lives in the /etc/cups directory. that's her home. her address. 🏠

Every single line in the file can be one of three things:

1. a configuration directive (the main character 👑)
2. a blank line (resting, as she deserves 😌)
3. a comment (and comment lines start with the # character — # is the "not me talking rn" symbol)

Now, here's the tea ☕: the Community and DebugLevel directives are used by all the backends, they're everybody's bestie. The remainder? They apply only to the SNMP backend — cups-snmp(8). exclusive. private. iykyk 🤫

---

🎀 DIRECTIVES 🎀

The following directives are understood by the CUPS network backends:

• Address @IF(name)
• Address @LOCAL
• Address address — Sends SNMP broadcast queries (for discovery 🔍) to the specified address(es). There is no default for the broadcast address. so if you want her to yell into the void, you gotta tell her where the void is 📢
• Community name — Specifies the community name to use. Only a single community name may be specified — she's monogamous, one and done 💜 The default community name is "public". And if no name is specified at all? then all SNMP functions are disabled. ghosted. blocked. unavailable. 💀
• DebugLevel number — Specifies the logging level from 0 (none) to 3 (everything). Typically only used for debugging (thus the name, so clever 🙈). The default debug level is 0.
• DeviceURI "regular expression" device-uri [... device-uri] — Specifies one or more device URIs that should be used for a given make and model string. The regular expression is used to match the detected make and model, and the device URI strings must be of the form "scheme://%s[:port]/[path]", where "%s" represents the detected address or hostname. There are no default device URI matching rules — you're building this from scratch, bestie, and that's iconic 🛠️✨
• HostNameLookups on
• HostNameLookups off — Specifies whether the addresses of printers should be converted to hostnames or left as numeric IP addresses. The default is "off".
• MaxRunTime seconds — Specifies the maximum number of seconds that the SNMP backend will scan the network for printers. The default is 120 seconds (2 minutes ⏱️). girl has a curfew.

---

👑 NOTES 👑

CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS. 😭 this is not a drill, this is a real warning.

Printers that do not support IPP can be supported using applications such as ippeveprinter(1) — so there's a glow-up path, don't panic 🫶

---

🦋 SEE ALSO 🦋

• cups-snmp(8)
• CUPS Online Help (http://localhost:631/help)

---

💅 COPYRIGHT 💅

Copyright © 2020-2024 by OpenPrinting.

---

and that's the whole page, bestie 🌈 this was snmp.conf(5) from OpenPrinting, dated 2021-02-28, and it's filed under CUPS — stay hydrated, stay deprecated-aware, and go read those NOTES one more time fr fr 💖✨🎀🦋🌸