SNMP_HOSTRES(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 SNMP_HOSTRES(3) — the host resources module, explained bestie-style

okay so this is the snmp_hostres page from the Library Functions Manual, and honestly? it's giving "niche but iconic." it's the host resources module for bsnmpd(8), and we're gonna get into all of it. no skipping. 🫶

📚 LIBRARY

(begemotSnmpdModulePath."hostres" = /usr/lib/snmp_hostres.so)

that's the whole library line, bestie — it's literally a module path assignment and nothing else. copy it exactly, don't get cute with it. ✨

🌸 DESCRIPTION

so the snmp_hostres module implements the HOST-RESOURCES-MIB, as standardized in RFC 2790. that's it. that's the vibe. it's the host resources girlie and she's standardized. 👑

💀 RESTRICTIONS

real talk: not all information in the MIB is meaningful in FreeBSD, or even available at all. these variables are either not implemented or they carry no information. 💅
  • hrFSType — there are several types of file systems for which no appropriate OID exists yet, and FreeBSD supports them anyway. for smbfs, procfs and devfs, hrFSOther is returned. in all other cases, hrFSUnknown. so basically: shrug emoji, we tried.
  • hrFSBootable — okay so what does bootable even mean here?? does it mean the BIOS is available to start a boot on that file system, or does it mean there's something bootable on it? genuinely questionable. either way, the info is not available, so this variable returns True for the root file system (which is not necessarily correct, bestie, noted) and False for all others.
  • hrFSLastFullBackupDate, hrFSLastPartialBackupDate — not available, always returns an empty string. theoretically it could be retrieved from /etc/dumpdates, but that would hardly be correct given the different ways of doing backups. so no. 🙈
  • hrDiskStorageTable — floppy devices are currently not reported. also, the names of the disks are hard-coded in the module. yeah. hard-coded. we don't talk about it. 😭

🎀 FILES

  • /usr/share/snmp/defs/hostres_tree.def — the description of the MIB tree implemented by snmp_hostres.
  • /usr/share/snmp/mibs/HOST-RESOURCES-TYPES.txt
  • /usr/share/snmp/mibs/HOST-RESOURCES-MIB.txt
  • /usr/share/snmp/mibs/BEGEMOT-HOSTRES-MIB.txt — this is the MIB that is implemented by this module. 👑

🦋 SEE ALSO

gensnmptree(1), snmpmod(3)

🌈 AUTHORS

Victor Cruceru <soc-victor@FreeBSD.org>

and that's the whole page, bestie, nothing left out, nothing invented. periodt. 💜

this icon of a manual page is from Debian, dated January 3, 2006 — yeah, she's been around a minute, and she still slays. 🎀✨

📦 where this page comes from