NETSNMP_TRAP_API(3)

✨ NAME ✨

okay so bestie, this is netsnmp_trap_api(3) from the Net-SNMP crew 💅 and it's the whole vibe for sending TRAPs and INFORMs out of a Net-SNMP MIB module 🎀

Meet the trio: send_easy_trap, send_trap_vars, and send_v2trap — they send TRAPs or INFORMs from a Net-SNMP MIB module. no cap. 🔥

---

🌸 SYNOPSIS 🌸

#include <net-snmp/agent/agent_trap.h>

void send_easy_trap(int trap, int specific);

void send_trap_vars(int trap, int specific, struct variable_list *vars);

void send_v2trap(struct variable_list *vars);

---

🦋 DESCRIPTION 🦋

So these three routines are your little group chat of trap-senders, and you can use them to send traps from a MIB module that lives inside the Net-SNMP agent (and yes, that includes an AgentX subagent, we see you 🫶).

• send_easy_trap() — sends an SNMPv1 trap (or the SNMPv2 equivalent, slay) to the list of configured trap destinations (aka "sinks"), using the values you handed it for the generic trap type and the specific trap value. lowkey the simplest one.
• send_trap_vars() — basically the same energy, but it appends the list of variable bindings you supply onto the traps that get sent. extra data, extra cute ✨
• send_v2trap() — takes your supplied list of variable bindings and uses them to form an SNMPv2 trap, which gets sent to the SNMPv2-capable sinks on the configured list. An equivalent INFORM goes to the configured list of inform sinks. Sinks that can only handle SNMPv1 traps get skipped entirely, sorry not sorry 💀

the way the trap formats actually work 🧚

The various "send_trap()" calls let you specify traps in different formats. And the various "trapsink" directives let you specify destinations to receive different formats. But — and this is the plot twist — *all* traps are sent to *all* destinations, regardless of how they were specified. I.e. it's:

                                        ___  trapsink
                                       /
   send_easy_trap ___  [  Trap      ] ____  trap2sink
                   ___  [ Generator  ]
   send_v2trap    /     [            ] ----- informsink
                                       ____
                                             trapsess

*Not* this, bestie:

    send_easy_trap  ------------------->  trapsink
    send_v2trap     ------------------->  trap2sink
    ????            ------------------->  informsink
    ????            ------------------->  trapsess

---

⚠️ WARNINGS ⚠️

These routines are used to send the traps immediately they are called. Like, zero chill, no queue, no waiting. 🚨

Invoking them at the appropriate time is left to the MIB module programmer — that's you, main character 👑. it's giving "your problem now" fr fr.

---

🔍 SEE ALSO 🔍

• snmpd.conf(5)
• snmptrapd(8)

---

okay that's the whole page babes 💖 this was Net-SNMP manual page NETSNMP_TRAP_API(3), version V5.9.5.2, dated 13 Aug 2010. iconic. historic. ate. periodt 💅✨🎀