SNMP::Info::Layer3::NetSNMP(3pm)

NAME
SNMP::Info::Layer3::NetSNMP - SNMP Interface to L3 Net-SNMP Devices

AUTHORS
Bradley Baetz and Bill Fenner

SYNOPSIS
 # Let SNMP::Info determine the correct subclass for you.
 my $netsnmp = new SNMP::Info(
                          AutoSpecify => 1,
                          Debug       => 1,
                          DestHost    => 'myrouter',
                          Community   => 'public',
                          Version     => 2
                        )
    or die "Can't connect to DestHost.\n";

 my $class      = $netsnmp->class();
 print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION
Subclass for Generic Net-SNMP devices

  Inherited Classes

SNMP::Info::Layer3

  Required MIBs
UCD-SNMP-MIB
NET-SNMP-TC
HOST-RESOURCES-MIB
Inherited Classes' MIBs
    See SNMP::Info::Layer3 for its own MIB requirements.

GLOBALS
These are methods that return scalar value from SNMP

$netsnmp->vendor()
    Returns 'Net-SNMP'.

$netsnmp->os()
    Returns the OS extracted from "sysDescr".

$netsnmp->os_ver()
    Returns the software version extracted from "sysDescr", along with the Net-SNMP version.

$netsnmp->uptime()
    Returns the system uptime instead of the agent uptime. NOTE: discontinuity timers and other Time Stamp based objects are based on agent uptime, so use orig_uptime().

$netsnmp->serial()
    Returns ''.

  Globals imported from SNMP::Info::Layer3
See documentation in SNMP::Info::Layer3 for details.

TABLE ENTRIES
These are methods that return tables of information in the form of a reference to a hash.

  Overrides

$netsnmp->i_ignore()
    Returns reference to hash. Increments value of IID if port is to be ignored.

    Ignores loopback

  Table Methods imported from SNMP::Info::Layer3
See documentation in SNMP::Info::Layer3 for details.

NOTES
In order to cause SNMP::Info to classify your device into this class, it may be necessary to put a configuration line into your snmpd.conf similar to

  sysobjectid .1.3.6.1.4.1.8072.3.2.N

where N is the object ID for your OS from the "NET-SNMP-TC" MIB (or 255 if not listed). Some Net-SNMP installations default to an incorrect return value for "system.sysObjectId".

In order to recognize a Net-SNMP device as Layer3, it may be necessary to put a configuration line similar to

  sysservices 76

in your snmpd.conf.