NAME

       send_easy_trap,  send_trap_vars,  send_v2trap  - send TRAPs or INFORMs from a Net-SNMP MIB
       module

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

       These three routines may be used to send traps from a MIB module within the Net-SNMP agent
       (including an AgentX subagent).

       send_easy_trap() sends an SNMPv1 trap (or the SNMPv2 equivalent) to the list of configured
       trap destinations (or "sinks"), using the provided values for the generic trap  type,  and
       specific trap value.

       send_trap_vars()  is  similar,  but  appends the supplied list of variable bindings to the
       traps that are sent.

       send_v2trap() uses the supplied list of variable bindings to form an SNMPv2 trap, which is
       sent  to SNMPv2-capable sinks on the configured list.  An equivalent INFORM is sent to the
       configuredq list of inform sinks.  Sinks that can only handle SNMPv1 traps are skipped.

       The various "send_trap()" calls allow you to specify traps in different formats.  And  the
       various  "trapsink"  directives  allow  you  to  specify destinations to receive different
       formats.  But *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*
            send_easy_trap  ------------------->  trapsink
            send_v2trap     ------------------->  trap2sink
            ????            ------------------->  informsink
            ????            ------------------->  trapsess

WARNINGS

       These  routines  are used to send the traps immediately they are called.  Invoking them at
       the appropriate time is left to the MIB module programmer.

SEE ALSO

       snmpd.conf(5), snmptrapd(8)