This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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  des-tinations destinations
       tinations (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 appro-priate appropriate
       priate 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)