1Info::FDP(3) User Contributed Perl Documentation Info::FDP(3)
2
6 SNMP::Info::FDP - SNMP Interface to Foundry Discovery Protocol (FDP)
7 using SNMP
8
10 Bruce Rodger, Max Baker
11
13 my $fdp = new SNMP::Info (
14 AutoSpecify => 1,
15 Debug => 1,
16 DestHost => 'router',
17 Community => 'public',
18 Version => 2
19 );
20 my $class = $fdp->class();
22 print " Using device sub class : $class\n";
23 $hasfdp = $fdp->hasFDP() ? 'yes' : 'no';
25 # Print out a map of device ports with FDP neighbors:
27 my $interfaces = $fdp->interfaces();
28 my $fdp_if = $fdp->fdp_if();
29 my $fdp_ip = $fdp->fdp_ip();
30 my $fdp_port = $fdp->fdp_port();
31 foreach my $fdp_key (keys %$fdp_ip){
33 my $iid = $fdp_if->{$fdp_key};
34 my $port = $interfaces->{$iid};
35 my $neighbor = $fdp_ip->{$fdp_key};
36 my $neighbor_port = $fdp_port->{$fdp_key};
37 print "Port : $port connected to $neighbor / $neighbor_port\n";
38 }
39
41 SNMP::Info::FDP is a subclass of SNMP::Info that provides an object
42 oriented interface to FDP information through SNMP.
43 FDP is a Layer 2 protocol that supplies topology information of devices
45 that also speak FDP, mostly switches and routers. It has similar
46 functionality to Cisco's CDP, and the SNMP interface is virtually
47 identical. FDP is implemented in Foundry devices, including the
48 Bigiron and Fastiron range.
49 Create or use a device subclass that inherits this class. Do not use
51 directly.
52 Each device implements a subset of the global and cache entries. Check
54 the return value to see if that data is held by the device.
55 Inherited Classes
57 None.
58 Required MIBs
60 FOUNDRY-SN-SWITCH-GROUP-MIB
61 Needs a reasonably recent MIB. Works OK with B2R07604A.mib, but
62 doesn't work with B2R07600C.
63
65 These are methods that return scalar values from SNMP
66 $fdp->hasFDP()
68 Is FDP is active in this device?
69 Accounts for SNMP version 1 devices which may have FDP but not
71 fdp_run()
72 $fdp->fdp_run()
74 Is FDP enabled on this device?
75 ("fdpGlobalRun")
77 $fdp->fdp_interval()
79 Interval in seconds at which FDP messages are generated.
80 ("fdpGlobalMessageInterval")
82 $fdp->fdp_holdtime()
84 Time in seconds that FDP messages are kept.
85 ("fdpGlobalHoldTime")
87 $fdp->fdp_id()
89 Returns FDP device ID.
90 This is the device id broadcast via FDP to other devices, and is
92 what is retrieved from remote devices with $fdp->id().
93 ("fdpGlobalDeviceId")
95 Overrides
97 CDP compatibility
98 $fdp->c_interval()
100 Interval in seconds at which FDP messages are generated.
101 ("fdpGlobalMessageInterval")
103 $fdp->c_holdtime()
105 Time in seconds that FDP messages are kept.
106 ("fdpGlobalHoldTime")
108 $fdp->c_id()
110 Returns FDP device ID.
111 This is the device id broadcast via FDP to other devices, and is
113 what is retrieved from remote devices with $fdp->id().
114 ("fdpGlobalDeviceId")
116 $cdp->cdp_run()
118 Is FDP enabled on this device?
119
121 These are methods that return tables of information in the form of a
122 reference to a hash.
123 Overrides
125 CDP compatibility
126 $fdp->c_capabilities()
128 Returns Device Functional Capabilities. Results are munged into an
129 ascii binary string, 7 digits long, MSB. Each digit represents a
130 bit from the table below.
131 From
133 <http://www.cisco.com/univercd/cc/td/doc/product/lan/trsrb/frames.htm#18843>:
134 (Bit) - Description
136 (0x40) - Provides level 1 functionality.
138 (0x20) - The bridge or switch does not forward IGMP Report packets
139 on non router ports.
140 (0x10) - Sends and receives packets for at least one network layer
141 protocol. If the device is routing the protocol, this bit should
142 not be set.
143 (0x08) - Performs level 2 switching. The difference between this
144 bit and bit 0x02 is that a switch does not run the Spanning-Tree
145 Protocol. This device is assumed to be deployed in a physical loop-
146 free topology.
147 (0x04) - Performs level 2 source-route bridging. A source-route
148 bridge would set both this bit and bit 0x02.
149 (0x02) - Performs level 2 transparent bridging.
150 (0x01) - Performs level 3 routing for at least one network layer
151 protocol.
152 Thanks to Martin Lorensen "martin -at- lorensen.dk" for a pointer
154 to this information.
155 ("fdpCacheCapabilities")
157 $fdp->c_domain()
159 The CDP version of this returns remote VTP Management Domain as
160 defined in "CISCO-VTP-MIB::managementDomainName"
161 ("fdpCacheVTPMgmtDomain")
163 $fdp->c_duplex()
165 Returns the port duplex status from remote devices.
166 ("fdpCacheDuplex")
168 $fdp->c_id()
170 Returns remote device id string
171 ("fdpCacheDeviceId")
173 $fdp->c_if()
175 Returns the mapping to the SNMP Interface Table.
176 Note that a lot devices don't implement $fdp->fdp_index(), So if
178 it isn't around, we fake it.
179 In order to map the fdp table entry back to the interfaces() entry,
181 we truncate the last number off of it :
182 # it exists, yay.
184 my $fdp_index = $device->fdp_index();
185 return $fdp_index if defined $fdp_index;
186 # if not, let's fake it
188 my $fdp_ip = $device->fdp_ip();
189 my %fdp_if
191 foreach my $key (keys %$fdp_ip){
192 $iid = $key;
193 ## Truncate off .1 from fdp response
194 $iid =~ s/\.\d+$//;
195 $fdp_if{$key} = $iid;
196 }
197 return \%fdp_if;
199 $fdp->c_index()
201 Returns the mapping to the SNMP2 Interface table for FDP Cache
202 Entries.
203 Most devices don't implement this, so you probably want to use
205 $fdp->fdp_if() instead.
206 See fdp_if() entry.
208 ("fdpCacheIfIndex")
210 $fdp->c_ip()
212 Returns remote IP address
213 ("fdpCacheAddress")
215 $fdp->c_platform()
217 Returns remote platform id
218 ("fdpCachePlatform")
220 $fdp->c_port()
222 Returns remote port ID
223 ("fdpDevicePort")
225 $fdp->c_proto()
227 Returns remote address type received. Usually IP.
228 ("fdpCacheAddressType")
230 $fdp->c_ver()
232 Returns remote hardware version
233 ("fdpCacheVersion")
235 $fdp->c_vlan()
237 Returns the remote interface native VLAN.
238 ("fdpCacheNativeVLAN")
240perl v5.12.0 2009-06-12 Info::FDP(3)