snmpa_discovery_handler(3)

💖 NAME 💖

snmpa_discovery_handler — the behaviour module for the SNMP agent discovery handler, bestie. That's literally what it is. 🦋

---

✨ DESCRIPTION ✨

Okay so listen. This module defines the behaviour of the agent discovery handler. If you're writing a module that wants to call itself snmpa_discovery_handler-compliant, it must export this function:

• stage1_finish/3

That's the whole list. The semantics of it and the exact signatures are explained right down below, no gatekeeping here 💅

---

💅 FUNCTIONS 💅

🎀 CALLBACKS 🎀

stage1_finish(TargetName, ManagerEngineID, ExtraInfo)

So this one gets called at the end of stage 1 of the discovery process, periodt. It should return either the atom ignore or {ok, usm_entry() | [usm_entry()]}. Wanna know more about that type? Go peek at usm_entry() and usm_entry/1,3, they got you. ✨

If the function returns ignore, then it's assumed that either:

• The caller (of the discovery function) will make the needed updates later. 🫶
• The callback function itself did the updates. 👑

Either way, the agent will do nothing — but it does return the retrieved ManagerEngineID (check snmpa:discovery/6 for more info on that) and it's possible to continue with stage 2 of the discovery process. Slay. 🌈

The ExtraInfo argument is passed on from the snmpa:discovery/6 function. 🌸

This function may return an updated NewExtraInfo that will be used in subsequent calls to the callback functions. It's intended for future use — so like, don't get too attached to it yet, iykyk. 🙈

The purpose of this function is to generate the usm-related security data needed for usm processing in the agent. Specifically, updating the usmUserTable. That's the mission, fr fr. 🔥

When an usm_entry() tuple (or a list of such tuples) is returned, this data is then added to the usmUserTable by the (master-) agent. 💖

When an usm_entry() tuple (or a list of such tuples) is returned, this data is then added to the usmUserTable by the (master-) agent. 💖

not me pointing out that yes bestie, that sentence is in here twice on purpose — the original page says it two times, so I'm saying it two times. we respect the source 💀

NOTE: Note that the function does not check if this entry already exists. So like... it will happily not care. 😭

NOTE: Note that this function is executed in the context of the master-agent process. Very main character of it, honestly. 👑

---

That's the whole vibe check, bestie — this page came from Ericsson AB, it's part of snmp version 5.20.5, and the manual page itself is snmpa_discovery_handler(3). Take care of her, she's iconic. 🎀✨💜