1SNMP::Info::Layer2::CatUasleyrstC(o3n)tributed Perl DocuSmNeMnPt:a:tIinofno::Layer2::Catalyst(3)
2
3
4

NAME

6       SNMP::Info::Layer2::Catalyst - SNMP Interface to Cisco Catalyst devices
7       running Catalyst OS.
8

AUTHOR

10       Max Baker
11

SYNOPSIS

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

DESCRIPTION

27       SNMP::Info subclass to provide information for Cisco Catalyst series
28       switches running CatOS.
29
30       This class includes the Catalyst 2920, 4000, 5000, 6000 (hybrid mode)
31       families.
32
33       This subclass is not for all devices that have the name Catalyst.  Note
34       that some Catalyst switches run IOS, like the 2900 and 3550 families.
35       Cisco Catalyst 1900 switches use their own MIB and have a separate
36       subclass.  Use the method above to have SNMP::Info determine the
37       appropriate subclass before using this class directly.
38
39       See SNMP::Info::device_type() for specifics.
40
41       Note:  Some older Catalyst switches will only talk SNMP version 1.
42       Some newer ones will not return all their data if connected via Version
43       1.
44
45       For speed or debugging purposes you can call the subclass directly, but
46       not after determining a more specific class using the method above.
47
48        my $cat = new SNMP::Info::Layer2::Catalyst(...);
49
50   Inherited Classes
51       SNMP::Info::Layer2::Cisco
52       SNMP::Info::CiscoStack
53
54   Required MIBs
55       Inherited Classes' MIBs
56           See "Required MIBs" in SNMP::Info::Layer2::Cisco for its own MIB
57           requirements.
58
59           See "Required MIBs" in SNMP::Info::CiscoStack for its own MIB
60           requirements.
61
62       These MIBs are found in the standard v2 MIBs from Cisco.
63

GLOBALS

65       These are methods that return scalar value from SNMP
66
67       $cat->os()
68           Returns 'catalyst'
69
70       $cat->os_ver()
71           Tries to use the value from SNMP::Info::CiscoStats->os_ver() and if
72           it fails it grabs $cat->m_swver()->{1} and uses that.
73
74       $cat->vendor()
75           Returns 'cisco'
76
77       $cat->cisco_comm_indexing()
78           Returns 1.  Use vlan indexing.
79
80   Global Methods imported from SNMP::Info::Layer2::Cisco
81       See documentation in "GLOBALS" in SNMP::Info::Layer2::Cisco for
82       details.
83
84   Global Methods imported from SNMP::Info::CiscoStack
85       See documentation in "GLOBALS" in SNMP::Info::CiscoStack for details.
86

TABLE METHODS

88       These are methods that return tables of information in the form of a
89       reference to a hash.
90
91   Overrides
92       $cat->interfaces()
93           Returns the map between SNMP Interface Identifier (iid) and
94           physical port name.
95
96       $cat->i_name()
97           Returns reference to hash of iid to human set name.
98
99           "portName"
100
101       $cat->i_physical()
102           Returns a map to IID for ports that are physical ports, not vlans,
103           etc.
104
105       $cat->bp_index()
106           Returns reference to hash of bridge port table entries map back to
107           interface identifier (iid)
108
109           Crosses ("portCrossIndex") to ("portIfIndex") since some devices
110           seem to have problems with BRIDGE-MIB
111
112   Table Methods imported from SNMP::Info::Layer2::Cisco
113       See documentation in "TABLE METHODS" in SNMP::Info::Layer2::Cisco for
114       details.
115
116   Table Methods imported from SNMP::Info::CiscoStack
117       See documentation in "TABLE METHODS" in SNMP::Info::CiscoStack for
118       details.
119
120
121
122perl v5.36.1                      2023-07-17   SNMP::Info::Layer2::Catalyst(3)
Impressum