Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

BridgeQuery
Perl extension for retrieving bridge tables.

BridgeQuery - Perl extension for retrieving bridge tables.


NAME

BridgeQuery - Perl extension for retrieving bridge tables.


SYNOPSIS


  use SNMP::BridgeQuery;

  use SNMP::BridgeQuery qw(querymacs queryports queryat);

  $fdb = queryfdb(host => $address,

                  comm => $community);

  unless (exists $fdb->{error}) {

     ($fdb->{$mac} = "n/a") unless (exists $fdb->{$mac});

     print "This MAC address was found on port: ".$fdb->{$mac}."\n";

  }


DESCRIPTION

BridgeQuery polls a device which responds to SNMP Bridge Table queries and generates a hash reference with each polled MAC address as the key and the associated port as the value. The specific MIBs that are polled are described in RFC1493.

SNMP::BridgeQuery requires Net::SNMP in order to function. (Checked for during 'perl Makefile.PL')

Devices can be switches, bridges, or most anything that responds as a OSI Layer 2 component. Layer 3 devices do not generally respond and will cause an error. If an error is generated, it will return a hash reference with a single element ('error') which can be tested for.

Two other functions (querymacs & queryports) can be explicitly exported. They work the same way as queryfdb, but they return MAC addresses or ports (respectively) with the SNMP MIB as the hash key.

A newly added function (queryat) can be used on layer 3 switches to poll the Address Translation Tables. This is similar to the data returned by the 'queryfdb' function, but it returns the IP address of the device and the associated interface (separated by a pipe '|') with the MAC address as the key. On a layer 3 switch, this interface probably does not correspond to a physical port, but more likely refers to a vlan ID. Using this function on a layer 2 device will generate a 'trapped' error.


ACKNOLEDGEMENTS

David M. Town - Author of Net::SNMP


AUTHOR

John D. Shearer <bridgequery@netguy.org>


SEE ALSO

perl(1), perldoc(1) Net::SNMP.


COPYRIGHT

Copyright (c) 2001-2003 John D. Shearer. All rights reverved. This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy