1SNMP::Info::FDP(3pm) User Contributed Perl Documentation SNMP::Info::FDP(3pm)
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 Brocade (Foundry) devices.
48 Create or use a device subclass that inherits this class. Do not use
50 directly.
51 Each device implements a subset of the global and cache entries. Check
53 the return value to see if that data is held by the device.
54 Inherited Classes
56 None.
57 Required MIBs
59 FOUNDRY-SN-SWITCH-GROUP-MIB
60 Needs a reasonably recent MIB. Works OK with B2R07604A.mib, but
61 doesn't work with B2R07600C.
62
64 These are methods that return scalar values from SNMP
65 $fdp->hasFDP()
67 Is FDP is active in this device?
68 Accounts for SNMP version 1 devices which may have FDP but not
70 fdp_run()
71 $fdp->fdp_run()
73 Is FDP enabled on this device?
74 ("fdpGlobalRun")
76 $fdp->fdp_interval()
78 Interval in seconds at which FDP messages are generated.
79 ("fdpGlobalMessageInterval")
81 $fdp->fdp_holdtime()
83 Time in seconds that FDP messages are kept.
84 ("fdpGlobalHoldTime")
86 Overrides
88 CDP compatibility
89 $fdp->fdp_interval()
91 Interval in seconds at which FDP messages are generated.
92 ("fdpGlobalMessageInterval")
94 $fdp->fdp_holdtime()
96 Time in seconds that FDP messages are kept.
97 ("fdpGlobalHoldTime")
99 $fdp->fdp_id()
101 Returns FDP device ID.
102 This is the device id broadcast via FDP to other devices, and is
104 what is retrieved from remote devices with $fdp->id().
105 ("fdpGlobalDeviceId")
107 $fdp->fdp_run()
109 Is FDP enabled on this device?
110
112 These are methods that return tables of information in the form of a
113 reference to a hash.
114 Overrides
116 CDP compatibility
117 $fdp->fdp_capabilities()
119 Returns Device Functional Capabilities. Results are munged into an
120 ascii binary string, MSB. Each digit represents a bit from the
121 table below.
122 From
124 <http://www.cisco.com/univercd/cc/td/doc/product/lan/trsrb/frames.htm#18843>:
125 (Bit) - Description
127 (0x40) - Provides level 1 functionality.
129 (0x20) - The bridge or switch does not forward IGMP Report packets
130 on non router ports.
131 (0x10) - Sends and receives packets for at least one network layer
132 protocol. If the device is routing the protocol, this bit should
133 not be set.
134 (0x08) - Performs level 2 switching. The difference between this
135 bit and bit 0x02 is that a switch does not run the Spanning-Tree
136 Protocol. This device is assumed to be deployed in a physical loop-
137 free topology.
138 (0x04) - Performs level 2 source-route bridging. A source-route
139 bridge would set both this bit and bit 0x02.
140 (0x02) - Performs level 2 transparent bridging.
141 (0x01) - Performs level 3 routing for at least one network layer
142 protocol.
143 Thanks to Martin Lorensen for a pointer to this information.
145 ("fdpCacheCapabilities")
147 $fdp->fdp_id()
149 Returns remote device id string
150 ("fdpCacheDeviceId")
152 $fdp->fdp_if()
154 Returns the mapping to the SNMP Interface Table.
155 In order to map the fdp table entry back to the interfaces() entry,
157 we truncate the last number off of it :
158 my $fdp_ip = $device->fdp_ip();
160 my %fdp_if
162 foreach my $key (keys %$fdp_ip){
163 $iid = $key;
164 ## Truncate off .1 from fdp response
165 $iid =~ s/\.\d+$//;
166 $fdp_if{$key} = $iid;
167 }
168 return \%fdp_if;
170 $fdp->fdp_ip()
172 Returns remote IP address
173 ("fdpCacheAddress")
175 $fdp->fdp_platform()
177 Returns remote platform id
178 ("fdpCachePlatform")
180 $fdp->fdp_port()
182 Returns remote port ID
183 ("fdpDevicePort")
185 $fdp->fdp_proto()
187 Returns remote address type received. Usually IP.
188 ("fdpCacheAddressType")
190 $fdp->fdp_ver()
192 Returns remote hardware version
193 ("fdpCacheVersion")
195 $fdp->fdp_cache_type()
197 Returns type of entry received, either FDP or CDP.
198 ("snFdpCacheVendorId")
200perl v5.38.0 2023-09-04 SNMP::Info::FDP(3pm)