Mon::SNMP(3) User Contributed Perl Documentation Mon::SNMP(3)NAMEMon::SNMP - decode SNMP trap
SYNOPSIS
use Mon::SNMP;
$trap = new Mon::SNMP;
$trap->buffer($snmptrap);
%traphash = $trap->decode;
$error = $trap->error;
DESCRIPTIONMon::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.
NOTESCAVEATSMon::SNMP depends upon Convert::BER to do the real work.
perl v5.14.0 2001-01-11 Mon::SNMP(3)