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.

           See SNMP::Info::LLDP 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.

   Globals imported from SNMP::Info::LLDP
       See documentation in SNMP::Info::LLDP 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.

   Table Methods imported from SNMP::Info::LLDP
       See documentation in SNMP::Info::LLDP 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.