1SNMP::Info::Layer3::NexUusse(r3)Contributed Perl DocumenStNaMtPi:o:nInfo::Layer3::Nexus(3)
2
3
4

NAME

6       SNMP::Info::Layer3::Nexus - SNMP Interface to Cisco Nexus Switches
7       running NX-OS
8

AUTHOR

10       Eric Miller
11

SYNOPSIS

13        # Let SNMP::Info determine the correct subclass for you.
14        my $nexus = new SNMP::Info(
15                                                       AutoSpecify => 1,
16                                                       Debug       => 1,
17                                                       # These arguments are passed directly to SNMP::Session
18                                                       DestHost    => 'myswitch',
19                                                       Community   => 'public',
20                                                       Version     => 2
21                                                       )
22               or die "Can't connect to DestHost.\n";
23
24        my $class      = $nexus->class();
25        print "SNMP::Info determined this device to fall under subclass : $class\n";
26

DESCRIPTION

28       Abstraction subclass for Cisco Nexus Switches running NX-OS.
29
30       For speed or debugging purposes you can call the subclass directly, but
31       not after determining a more specific class using the method above.
32
33        my $nexus = new SNMP::Info::Layer3::Nexus(...);
34
35   Inherited Classes
36       SNMP::Info::Layer3::CiscoSwitch
37
38   Required MIBs
39       CISCO-ENTITY-VENDORTYPE-OID-MIB
40       CISCO-CONTEXT-MAPPING-MIB
41       Inherited Classes' MIBs
42           See "Required MIBs" in SNMP::Info::Layer3::CiscoSwitch for its own
43           MIB requirements.
44

GLOBALS

46       These are methods that return a scalar value from SNMP
47
48       $nexus->os()
49           Returns 'nx-os'
50
51       $nexus->os_ver()
52           Returns operating system version extracted from "sysDescr".
53
54       $nexus->serial()
55           Returns the serial number of the chassis from ENTITY-MIB.
56
57       $nexus->model()
58           Tries to reference $nexus->id() to CISCO-ENTITY-VENDORTYPE-OID-MIB
59
60           Removes 'cevChassis' for readability.
61
62       $nexus->mac()
63           "dot1dBaseBridgeAddress"
64
65   Overrides
66       IP Address Table
67
68       Each entry in this table is an IP address in use on this device.  Some
69       versions do not index the table with the IPv4 address in accordance
70       with the MIB definition, these overrides correct that behavior.
71
72       Also, the table is augmented with IP addresses in use by UDP sockets on
73       the device, as determined by checking RFC1213-MIB::udpLocalAddress.
74       Valid addresses from this table (any IPv4 that is not localhost,
75       0.0.0.0, Class D (multicast) or Class E (experimental) are added as a
76       /32 on interface ID 0.  This is a workaround to determine possible VPC
77       Keepalive IP addresses on the device, which are probably advertised by
78       CDP/LLDP to neighbors.
79
80       $nexus->ip_index()
81           Maps the IP Table to the IID
82
83           ("ipAdEntIfIndex")
84
85       $nexus->ip_table()
86           Maps the Table to the IP address
87
88           ("ipAdEntAddr")
89
90       $nexus->ip_netmask()
91           Gives netmask setting for IP table entry.
92
93           ("ipAdEntNetMask")
94
95       $nexus->ip_broadcast()
96           Gives broadcast address for IP table entry.
97
98           ("ipAdEntBcastAddr")
99
100       $nexus->lldp_lport_desc()
101           On nx-os 6 only this will return data from "lldpLocPortId" instead
102           of the expected "lldpLocPortDesc". For all other nx-os versions
103           uses the function from SNMP::Info::LLDP.
104
105   Globals imported from SNMP::Info::Layer3::CiscoSwitch
106       See documentation in "GLOBALS" in SNMP::Info::Layer3::CiscoSwitch for
107       details.
108

TABLE METHODS

110       These are methods that return tables of information in the form of a
111       reference to a hash.
112
113   Table Methods imported from SNMP::Info::Layer3::CiscoSwitch
114       See documentation in "TABLE METHODS" in SNMP::Info::Layer3::CiscoSwitch
115       for details.
116
117
118
119perl v5.34.0                      2021-09-13      SNMP::Info::Layer3::Nexus(3)
Impressum