SNMP::Info::Layer2::Catalyst(3pm)

1Info::Layer2::Catalyst(U3s)er Contributed Perl DocumentatIinofno::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::CiscoStack
52       SNMP::Info::CiscoVTP
53       SNMP::Info::CDP
54       SNMP::Info::CiscoStats
55       SNMP::Info::CiscoPortSecurity
56       SNMP::Info::Layer2
57
58   Required MIBs
59       Inherited Classes' MIBs
60           See "Required MIBs" in SNMP::Info::CiscoStack for its own MIB
61           requirements.
62
63           See "Required MIBs" in SNMP::Info::CiscoVTP for its own MIB
64           requirements.
65
66           See "Required MIBs" in SNMP::Info::CDP for its own MIB
67           requirements.
68
69           See "Required MIBs" in SNMP::Info::CiscoStats for its own MIB
70           requirements.
71
72           See "Required MIBs" in SNMP::Info::CiscoPortSecurity for its own
73           MIB requirements.
74
75           See "Required MIBs" in SNMP::Info::Layer2 for its own MIB
76           requirements.
77
78       These MIBs are found in the standard v2 MIBs from Cisco.
79

GLOBALS

81       These are methods that return scalar value from SNMP
82
83       $cat->os()
84           Returns 'catalyst'
85
86       $cat->os_ver()
87           Tries to use the value from SNMP::Info::CiscoStats->os_ver() and if
88           it fails it grabs $cat->m_swver()->{1} and uses that.
89
90       $cat->vendor()
91           Returns 'cisco'
92
93       $cat->cisco_comm_indexing()
94           Returns 1.  Use vlan indexing.
95
96   Global Methods imported from SNMP::Info::CiscoStack
97       See documentation in "GLOBALS" in SNMP::Info::CiscoStack for details.
98
99   Globals imported from SNMP::Info::CiscoVTP
100       See documentation in "GLOBALS" in SNMP::Info::CiscoVTP for details.
101
102   Global Methods imported from SNMP::Info::CDP
103       See documentation in "GLOBALS" in SNMP::Info::CDP for details.
104
105   Global Methods imported from SNMP::Info::CiscoStats
106       See documentation in "GLOBALS" in SNMP::Info::CiscoStats for details.
107
108   Global Methods imported from SNMP::Info::CiscoPortSecurity
109       See documentation in "GLOBALS" in SNMP::Info::CiscoPortSecurity for
110       details.
111
112   Globals imported from SNMP::Info::Layer2
113       See documentation in "GLOBALS" in SNMP::Info::Layer2 for details.
114

TABLE METHODS

116       These are methods that return tables of information in the form of a
117       reference to a hash.
118
119   Overrides
120       $cat->interfaces()
121           Returns the map between SNMP Interface Identifier (iid) and
122           physical port name.
123
124       $cat->i_name()
125           Returns reference to hash of iid to human set name.
126
127           "portName"
128
129       $cat->i_physical()
130           Returns a map to IID for ports that are physical ports, not vlans,
131           etc.
132
133       $cat->bp_index()
134           Returns reference to hash of bridge port table entries map back to
135           interface identifier (iid)
136
137           Crosses ("portCrossIndex") to ("portIfIndex") since some devices
138           seem to have problems with BRIDGE-MIB
139
140   Table Methods imported from SNMP::Info::CiscoStack
141       See documentation in "TABLE METHODS" in SNMP::Info::CiscoStack for
142       details.
143
144   Table Methods imported from SNMP::Info::CiscoVTP
145       See documentation in "TABLE METHODS" in SNMP::Info::CiscoVTP for
146       details.
147
148   Table Methods imported from SNMP::Info::CDP
149       See documentation in "TABLE METHODS" in SNMP::Info::CDP for details.
150
151   Table Methods imported from SNMP::Info::CiscoStats
152       See documentation in "TABLE METHODS" in SNMP::Info::CiscoStats for
153       details.
154
155   Table Methods imported from SNMP::Info::CiscoPortSecurity
156       See documentation in "TABLE METHODS" in SNMP::Info::CiscoPortSecurity
157       for details.
158
159   Table Methods imported from SNMP::Info::Layer2
160       See documentation in "TABLE METHODS" in SNMP::Info::Layer2 for details.
161
162
163
164perl v5.12.0                      2009-06-12         Info::Layer2::Catalyst(3)