Jim Trocki > Mon-0.11 > Mon::SNMP

Download:
Mon-0.11.tar.gz

Dependencies

Annotate this POD

Related Modules

Net::SNMP
Convert::BER
Class::Accessor
more...
By perlmonks.org

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.11   Source  

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

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.

syntax highlighting: