redhat man page for snmp_trap_api

SNMP_TRAP_API(3)						     Net-SNMP							  SNMP_TRAP_API(3)

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 pro-
       vided 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.

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)

4.2 Berkeley Distribution					    7 Mar 2002							  SNMP_TRAP_API(3)