.TH NETSNMP_TRAP_API 3 "13 Aug 2010" VVERSIONINFO "Net-SNMP"

.SH NAME

send_easy_trap,

send_trap_vars,

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

.SH SYNOPSIS

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

.PP

.BI "void send_easy_trap(int " trap ", int " specific ");"

.PP

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

.PP

.BI "void send_v2trap(struct variable_list *" vars ");"

.SH DESCRIPTION

These three routines may be used to send traps from a MIB module

within the Net-SNMP agent (including an AgentX subagent).

.PP

.B 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.

.PP

.B send_trap_vars()

is similar, but appends the supplied list of variable bindings to the

traps that are sent.

.PP

.B 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.

.PP

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.

.nf

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

.fi

.SH 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.

.SH "SEE ALSO"

.BR snmpd.conf "(5), " snmptrapd "(8)"