NAME

       Mon::SNMP - decode SNMP trap

SYNOPSIS

           use Mon::SNMP;

           $trap = new Mon::SNMP;

           $trap->buffer($snmptrap);

           %traphash = $trap->decode;

           $error = $trap->error;

DESCRIPTION

       Mon::SNMP provides methods to decode SNMP trap PDUs. It is based on Graham Barr's
       Convert::BER module, and its purpose is to provide SNMP trap handling to "mon".

       It is not complete, so don't bother trying to use it unless you are ready to debug and
       write some code.

METHODS

       new creates a new Mon::SNMP object.

       buffer ( buffer )
           Assigns a raw SNMP trap message to the object.

       decode
           Decodes a SNMP trap message, and returns a hash of the variable assignments for the
           SNMP header and trap protocol data unit of the associated message. The hash consists
           of the following members:

                   version         =>      SNMP version (1)
                   community       =>      community string
                   ent_OID         =>      enterprise OID of originating agent
                   agentaddr       =>      IP address of originating agent
                   generic_trap    =>      /COLDSTART|WARMSTART|LINKDOWN|LINKUP|AUTHFAIL|EGPNEIGHBORLOSS|ENTERPRISESPECIFIC/
                   specific_trap   =>      specific trap type (integer)
                   timeticks       =>      timeticks (integer)
                   varbindlist     =>      { oid1 => value, oid2 => value, ... }

ERRORS

       All methods return a hash with no elements upon errors which they detect, and the detail
       of the error is available from the

EXAMPLES

           use Mon::SNMP;

           $trap = new Mon::SNMP;

           $trap->buffer($snmptrap);

           %traphash = $trap->decode;

           foreach $oid (keys $traphash{"varbindlist"}) {
               $val = $traphash{"varbindlist"}{$oid};
               print "oid($oid) = val($val)\n";
           }

ENVIRONMENT

       None.

SEE ALSO

       Graham Barr's Convert::BER module.

NOTES

CAVEATS

       Mon::SNMP depends upon Convert::BER to do the real work.