debian man page for mon::snmp

Mon::SNMP(3pm)						User Contributed Perl Documentation					    Mon::SNMP(3pm)

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)
";
	   }

ENVIRONMENT
       None.

SEE ALSO
       Graham Barr's Convert::BER module.

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

perl v5.14.2							    2012-04-27							    Mon::SNMP(3pm)