 a98e163c7c
			
		
	
	a98e163c7c
	
	
	
		
			
			qb_fw_mac, qb_fw_port, qb_fw_status. These can be used directly in place of fw_mac, fw_port, fw_status for devices that only populate dot1qFdbTable and not dot1dFdbTable.
		
			
				
	
	
		
			656 lines
		
	
	
		
			18 KiB
		
	
	
	
		
			Perl
		
	
	
	
	
	
			
		
		
	
	
			656 lines
		
	
	
		
			18 KiB
		
	
	
	
		
			Perl
		
	
	
	
	
	
| # SNMP::Info::Bridge
 | |
| # Max Baker
 | |
| #
 | |
| # Changes since Version 0.7 Copyright (c) 2004 Max Baker 
 | |
| # All rights reserved.  
 | |
| #
 | |
| # Copyright (c) 2002,2003 Regents of the University of California
 | |
| # All rights reserved.
 | |
| #
 | |
| # 
 | |
| # Redistribution and use in source and binary forms, with or without 
 | |
| # modification, are permitted provided that the following conditions are met:
 | |
| # 
 | |
| #     * Redistributions of source code must retain the above copyright notice,
 | |
| #       this list of conditions and the following disclaimer.
 | |
| #     * Redistributions in binary form must reproduce the above copyright notice,
 | |
| #       this list of conditions and the following disclaimer in the documentation
 | |
| #       and/or other materials provided with the distribution.
 | |
| #     * Neither the name of the University of California, Santa Cruz nor the 
 | |
| #       names of its contributors may be used to endorse or promote products 
 | |
| #       derived from this software without specific prior written permission.
 | |
| # 
 | |
| # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 | |
| # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
 | |
| # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
 | |
| # DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
 | |
| # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 | |
| # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
 | |
| # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 | |
| # ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
 | |
| # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
 | |
| # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 | |
| 
 | |
| package SNMP::Info::Bridge;
 | |
| $VERSION = '1.05';
 | |
| # $Id$
 | |
| 
 | |
| use strict;
 | |
| 
 | |
| use Exporter;
 | |
| use SNMP::Info;
 | |
| 
 | |
| use vars qw/$VERSION $DEBUG %MIBS %FUNCS %GLOBALS %MUNGE $INIT/;
 | |
| @SNMP::Info::Bridge::ISA = qw/SNMP::Info Exporter/;
 | |
| @SNMP::Info::Bridge::EXPORT_OK = qw//;
 | |
| 
 | |
| %MIBS    = ('BRIDGE-MIB'   => 'dot1dBaseBridgeAddress',
 | |
|             'Q-BRIDGE-MIB' => 'dot1qPvid',
 | |
|            );
 | |
| 
 | |
| %GLOBALS = (
 | |
|             'b_mac'    => 'dot1dBaseBridgeAddress',
 | |
|             'b_ports'  => 'dot1dBaseNumPorts',
 | |
|             'b_type'   => 'dot1dBaseType',
 | |
|             # Spanning Tree Protocol
 | |
|             'stp_ver'  => 'dot1dStpProtocolSpecification',
 | |
|             'stp_time' => 'dot1dStpTimeSinceTopologyChange',
 | |
|             'stp_root' => 'dot1dStpDesignatedRoot',
 | |
|             # Q-BRIDGE-MIB
 | |
|             'qb_vlans_max'        => 'dot1qMaxSupportedVlans',
 | |
|             'qb_vlans'            => 'dot1qNumVlans',
 | |
|             'qb_next_vlan_index'  => 'dot1qNextFreeLocalVlanIndex',
 | |
|            );
 | |
| 
 | |
| %FUNCS = (
 | |
|           # Forwarding Table: Dot1dTpFdbEntry 
 | |
|           'fw_mac'    => 'dot1dTpFdbAddress',
 | |
|           'fw_port'   => 'dot1dTpFdbPort',
 | |
|           'fw_status' => 'dot1dTpFdbStatus',
 | |
|           # Bridge Port Table: Dot1dBasePortEntry
 | |
|           'bp_index'  => 'dot1dBasePortIfIndex',
 | |
|           'bp_port'   => 'dot1dBasePortCircuit',
 | |
|           # Bridge Static (Destination-Address Filtering) Database
 | |
|           'bs_mac'    => 'dot1dStaticAddress',
 | |
|           'bs_port'   => 'dot1dStaticReceivePort',
 | |
|           'bs_to'     => 'dot1dStaticAllowedToGoTo',
 | |
|           'bs_status' => 'dot1dStaticStatus',
 | |
|           # Spanning Tree Protocol Table : dot1dStpPortTable
 | |
|           'stp_p_id'       => 'dot1dStpPort',
 | |
|           'stp_p_priority' => 'dot1dStpPortPriority',
 | |
|           'stp_p_state'    => 'dot1dStpPortState',
 | |
|           'stp_p_cost'     => 'dot1dStpPortPathCost',
 | |
|           'stp_p_root'     => 'dot1dStpPortDesignatedRoot',
 | |
|           'stp_p_bridge'   => 'dot1dStpPortDesignatedBridge',
 | |
|           'stp_p_port'     => 'dot1dStpPortDesignatedPort',
 | |
|           # Q-BRIDGE-MIB : dot1qPortVlanTable
 | |
|           'qb_i_vlan'        => 'dot1qPvid',
 | |
|           'qb_i_vlan_type'   => 'dot1qPortAcceptableFrameTypes',
 | |
|           'qb_i_vlan_in_flt' => 'dot1qPortIngressFiltering',
 | |
|           # Q-BRIDGE-MIB : dot1qVlanStaticTable
 | |
|           'qb_v_name'        => 'dot1qVlanStaticName',
 | |
|           'qb_v_egress'      => 'dot1qVlanStaticEgressPorts',
 | |
|           'qb_v_fbdn_egress' => 'dot1qVlanForbiddenEgressPorts',
 | |
|           'qb_v_untagged'    => 'dot1qVlanStaticUntaggedPorts',
 | |
|           'qb_v_stat'        => 'dot1qVlanStaticRowStatus',
 | |
|           # VLAN Forwarding Table: Dot1qTpFdbEntry
 | |
|           'qb_fw_port'       => 'dot1qTpFdbPort',
 | |
|           'qb_fw_status'     => 'dot1qTpFdbStatus',
 | |
|           );
 | |
| 
 | |
| %MUNGE = (
 | |
|           # Inherit all the built in munging
 | |
|           %SNMP::Info::MUNGE,
 | |
|           # Add ones for our class
 | |
|           'b_mac'        => \&SNMP::Info::munge_mac,
 | |
|           'fw_mac'       => \&SNMP::Info::munge_mac,
 | |
|           'bs_mac'       => \&SNMP::Info::munge_mac,
 | |
|           'stp_root'     => \&SNMP::Info::munge_mac,
 | |
|           'stp_p_root'   => \&SNMP::Info::munge_mac,
 | |
|           'stp_p_bridge' => \&SNMP::Info::munge_mac,
 | |
|           'stp_p_port'   => \&SNMP::Info::munge_mac
 | |
|          );
 | |
| 
 | |
| # break up the Dot1qTpFdbEntry INDEX into FDB ID and MAC Address.
 | |
| sub _qb_fdbtable_index {
 | |
|     my $idx = shift;
 | |
|     my @values = split(/\./, $idx);
 | |
|     my $fdb_id = shift(@values);
 | |
|     return ($fdb_id, join(':',map { sprintf "%02x",$_ } @values));
 | |
| }
 | |
| 
 | |
| sub qb_fw_mac {
 | |
|     my $bridge = shift;
 | |
|     my $qb_fw_port = $bridge->qb_fw_port();
 | |
|     my $qb_fw_mac = {};
 | |
|     foreach my $idx (keys %$qb_fw_port) {
 | |
|         my($fdb_id, $mac) = _qb_fdbtable_index($idx);
 | |
|         $qb_fw_mac->{$idx} = $mac;
 | |
|     }
 | |
|     $qb_fw_mac;
 | |
| }
 | |
| 
 | |
| sub qb_i_vlan_t {
 | |
|     my $bridge = shift;
 | |
| 
 | |
|     my $qb_i_vlan      = $bridge->qb_i_vlan();
 | |
|     my $qb_i_vlan_type = $bridge->qb_i_vlan_type();
 | |
|         
 | |
|     my $i_vlan = {};
 | |
| 
 | |
|     foreach my $if (keys %$qb_i_vlan){
 | |
|         my $vlan   = $qb_i_vlan->{$if};
 | |
|         my $tagged = $qb_i_vlan_type->{$if} || '';
 | |
|         next unless defined $vlan;
 | |
|         $i_vlan->{$if} = $tagged eq 'admitOnlyVlanTagged' ? 'trunk' : $vlan;
 | |
|     }
 | |
|     return $i_vlan;
 | |
| }
 | |
| 
 | |
| sub i_stp_state {
 | |
|     my $bridge = shift;
 | |
|     my $bp_index = $bridge->bp_index();
 | |
|     my $stp_p_state = $bridge->stp_p_state();
 | |
| 
 | |
|     my %i_stp_state;
 | |
| 
 | |
|     foreach my $index (keys %$stp_p_state){
 | |
|         my $state = $stp_p_state->{$index};
 | |
|         my $iid   = $bp_index->{$index};
 | |
|         next unless defined $iid;
 | |
|         next unless defined $state;
 | |
|         $i_stp_state{$iid}=$state;
 | |
|     }
 | |
| 
 | |
|     return \%i_stp_state;
 | |
| }
 | |
| 
 | |
| sub i_stp_port {
 | |
|     my $bridge = shift;    
 | |
|     my $bp_index = $bridge->bp_index();
 | |
|     my $stp_p_port = $bridge->stp_p_port();
 | |
|     
 | |
|     my %i_stp_port;
 | |
| 
 | |
|     foreach my $index (keys %$stp_p_port){
 | |
|        my $bridge = $stp_p_port->{$index};
 | |
|        my $iid   = $bp_index->{$index};
 | |
|        next unless defined $iid;
 | |
|        next unless defined $bridge;
 | |
|        $i_stp_port{$iid}=$bridge;
 | |
|     }
 | |
|     return \%i_stp_port;
 | |
| }
 | |
| 
 | |
| sub i_stp_id {
 | |
|     my $bridge = shift;
 | |
|     my $bp_index = $bridge->bp_index();
 | |
|     my $stp_p_id = $bridge->stp_p_id();
 | |
| 
 | |
|     my %i_stp_id;
 | |
| 
 | |
|     foreach my $index (keys %$stp_p_id){
 | |
|         my $bridge = $stp_p_id->{$index};
 | |
|         my $iid   = $bp_index->{$index};
 | |
|         next unless defined $iid;
 | |
|         next unless defined $bridge;
 | |
|         $i_stp_id{$iid}=$bridge;
 | |
|     }
 | |
|     return \%i_stp_id;
 | |
| }
 | |
| 
 | |
| sub i_stp_bridge {
 | |
|     my $bridge = shift;
 | |
|     my $bp_index = $bridge->bp_index();
 | |
|     my $stp_p_bridge = $bridge->stp_p_bridge();
 | |
| 
 | |
|     my %i_stp_bridge;
 | |
| 
 | |
|     foreach my $index (keys %$stp_p_bridge){
 | |
|         my $bridge = $stp_p_bridge->{$index};
 | |
|         my $iid   = $bp_index->{$index};
 | |
|         next unless defined $iid;
 | |
|         next unless defined $bridge;
 | |
|         $i_stp_bridge{$iid}=$bridge;
 | |
|     }
 | |
|     return \%i_stp_bridge;
 | |
| }
 | |
| 
 | |
| #
 | |
| # These are internal methods and are not documented.  Do not use directly. 
 | |
| #
 | |
| sub check_forbidden_ports {
 | |
|     my $bridge = shift;
 | |
|     my ($vlan_id, $ifindex) = @_;
 | |
|     return undef unless ($vlan_id =~ /\d+/ and $ifindex =~ /\d+/);
 | |
| 
 | |
|     my $iv_forbidden = $bridge->qb_v_fbdn_egress($vlan_id);
 | |
| 
 | |
|     my @forbidden_ports = split(//, unpack("B*", $iv_forbidden->{$vlan_id}));
 | |
|     print "Forbidden ports: @forbidden_ports\n" if $bridge->debug();
 | |
|     if ( defined($forbidden_ports[$ifindex]) and ($forbidden_ports[$ifindex] eq "1")) {
 | |
|         print "Error: IfIndex: $ifindex in forbidden list for VLAN: $vlan_id unable to add\n" if $bridge->debug();
 | |
|         return undef;
 | |
|     }
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| sub add_to_egress_portlist {
 | |
|     my $bridge = shift;
 | |
|     my ($vlan_id, $ifindex) = @_;
 | |
|     return undef unless ($vlan_id =~ /\d+/ and $ifindex =~ /\d+/);
 | |
| 
 | |
|     my $iv_members   = $bridge->qb_v_egress($vlan_id);
 | |
| 
 | |
|     my @egress_list = split(//, unpack("B*", $iv_members->{$vlan_id}));
 | |
|     print "Original egress list for VLAN: $vlan_id: @egress_list \n" if $bridge->debug();
 | |
|     $egress_list[$ifindex] = '1';
 | |
|     # Some devices do not populate the portlist with all possible ports.
 | |
|     # If we have lengthened the list fill all undefined elements with zero.
 | |
|     foreach my $item (@egress_list) {
 | |
|         $item = '0' unless (defined($item));
 | |
|     }
 | |
|     print "Modified egress list for VLAN: $vlan_id: @egress_list \n" if $bridge->debug();
 | |
|     my $new_egress = pack("B*", join('', @egress_list));
 | |
| 
 | |
|     my $egress_rv = $bridge->set_qb_v_egress($new_egress, $vlan_id);
 | |
|     unless ($egress_rv) {
 | |
|         print "Error: Unable to add VLAN: $vlan_id to IfIndex: $ifindex egress list\n" if $bridge->debug();
 | |
|         return undef;
 | |
|     }
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| sub remove_from_egress_portlist {
 | |
|     my $bridge = shift;
 | |
|     my ($vlan_id, $ifindex) = @_;
 | |
|     return undef unless ($vlan_id =~ /\d+/ and $ifindex =~ /\d+/);
 | |
| 
 | |
|     my $iv_members   = $bridge->qb_v_egress($vlan_id);
 | |
| 
 | |
|     my @egress_list = split(//, unpack("B*", $iv_members->{$vlan_id}));
 | |
|     print "Original egress list for VLAN: $vlan_id: @egress_list \n" if $bridge->debug();
 | |
|     # Some devices may remove automatically, so check state before set
 | |
|     if ( defined($egress_list[$ifindex]) and ($egress_list[$ifindex] eq "1")) {
 | |
|         $egress_list[$ifindex] = '0';
 | |
|         print "Modified egress list for VLAN: $vlan_id: @egress_list \n" if $bridge->debug();
 | |
|         my $new_egress = pack("B*", join('', @egress_list));
 | |
| 
 | |
|         my $egress_rv = $bridge->set_qb_v_egress($new_egress, $vlan_id);
 | |
|         unless ($egress_rv) {
 | |
|             print "Warning: Unable to remove IfIndex: $ifindex from VLAN: $vlan_id egress list\n" if $bridge->debug();
 | |
|             return undef;
 | |
|         }  
 | |
|     }
 | |
|     return 1;
 | |
| }
 | |
| 
 | |
| 1;
 | |
| 
 | |
| __END__
 | |
| 
 | |
| 
 | |
| =head1 NAME
 | |
| 
 | |
| SNMP::Info::Bridge - SNMP Interface to SNMP data available through the
 | |
| BRIDGE-MIB (RFC1493)
 | |
| 
 | |
| =head1 AUTHOR
 | |
| 
 | |
| Max Baker
 | |
| 
 | |
| =head1 SYNOPSIS
 | |
| 
 | |
|  my $bridge = new SNMP::Info ( 
 | |
|                              AutoSpecify => 1,
 | |
|                              Debug       => 1,
 | |
|                              DestHost    => 'switch', 
 | |
|                              Community   => 'public',
 | |
|                              Version     => 2
 | |
|                              );
 | |
| 
 | |
|  my $class = $bridge->class();
 | |
|  print " Using device sub class : $class\n";
 | |
| 
 | |
|  # Grab Forwarding Tables
 | |
|  my $interfaces = $bridge->interfaces();
 | |
|  my $fw_mac     = $bridge->fw_mac();
 | |
|  my $fw_port    = $bridge->fw_port();
 | |
|  my $bp_index   = $bridge->bp_index();
 | |
| 
 | |
|  foreach my $fw_index (keys %$fw_mac){
 | |
|     my $mac   = $fw_mac->{$fw_index};
 | |
|     my $bp_id = $fw_port->{$fw_index};
 | |
|     my $iid   = $bp_index->{$bp_id};
 | |
|     my $port  = $interfaces->{$iid};
 | |
| 
 | |
|     print "Port:$port forwarding to $mac\n";
 | |
|  } 
 | |
| 
 | |
| =head1 DESCRIPTION
 | |
| 
 | |
| BRIDGE-MIB is used by most Layer 2 devices, and holds information like the
 | |
| MAC Forwarding Table and Spanning Tree Protocol info.
 | |
| 
 | |
| Q-BRIDGE-MIB holds 802.11q information -- VLANs and Trunking.  Cisco tends not
 | |
| to use this MIB, but some proprietary ones.  HP and some nicer vendors use
 | |
| this.  This is from C<RFC2674_q>.  
 | |
| 
 | |
| Create or use a subclass of SNMP::Info that inherits this class.  Do not use directly.
 | |
| 
 | |
| For debugging you can call new() directly as you would in SNMP::Info 
 | |
| 
 | |
|  my $bridge = new SNMP::Info::Bridge(...);
 | |
| 
 | |
| =head2 Inherited Classes
 | |
| 
 | |
| None.
 | |
| 
 | |
| =head2 Required MIBs
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item BRIDGE-MIB
 | |
| 
 | |
| =item Q-BRIDGE-MIB
 | |
| 
 | |
| F<rfc2674_q.mib>
 | |
| 
 | |
| =back
 | |
| 
 | |
| BRIDGE-MIB needs to be extracted from ftp://ftp.cisco.com/pub/mibs/v1/v1.tar.gz
 | |
| 
 | |
| =head1 GLOBAL METHODS
 | |
| 
 | |
| These are methods that return scalar values from SNMP
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->b_mac()
 | |
| 
 | |
| Returns the MAC Address of the root bridge port
 | |
| 
 | |
| (B<dot1dBaseBridgeAddress>)
 | |
| 
 | |
| =item $bridge->b_ports()
 | |
| 
 | |
| Returns the number of ports in device
 | |
| 
 | |
| (B<dot1dBaseNumPorts>)
 | |
| 
 | |
| =item $bridge->b_type()
 | |
| 
 | |
| Returns the type of bridging this bridge can perform, transparent and/or
 | |
| sourceroute.
 | |
| 
 | |
| (B<dot1dBaseType>)
 | |
| 
 | |
| =item $bridge->stp_ver()
 | |
| 
 | |
| Returns what version of STP the device is running.  Either decLb100 or ieee8021d.
 | |
| 
 | |
| (B<dot1dStpProtocolSpecification>)
 | |
| 
 | |
| =item $bridge->stp_time()
 | |
| 
 | |
| Returns time since last topology change detected. (100ths/second)
 | |
| 
 | |
| (B<dot1dStpTimeSinceTopologyChange>)
 | |
| 
 | |
| =item $bridge->stp_root()
 | |
| 
 | |
| Returns root of STP.
 | |
| 
 | |
| (B<dot1dStpDesignatedRoot>)
 | |
| 
 | |
| =item $bridge->qb_vlans_max() 
 | |
| 
 | |
| Maximum number of VLANS supported on this device.
 | |
| 
 | |
| (B<dot1qMaxSupportedVlans>)
 | |
| 
 | |
| =item $bridge->qb_vlans() 
 | |
| 
 | |
| Current number of VLANs that are configured in this device.
 | |
| 
 | |
| (B<dot1qNumVlans>)
 | |
| 
 | |
| =item $bridge->qb_next_vlan_index() 
 | |
| 
 | |
| The next available value for B<dot1qVlanIndex> of a local VLAN entry in
 | |
| B<dot1qVlanStaticTable>
 | |
| 
 | |
| (B<dot1qNextFreeLocalVlanIndex>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head1 TABLE METHODS
 | |
| 
 | |
| These are methods that return tables of information in the form of a reference
 | |
| to a hash.
 | |
| 
 | |
| =head2 Forwarding Table (dot1dTpFdbEntry)
 | |
| 
 | |
| =over 
 | |
| 
 | |
| =item $bridge->fw_mac()
 | |
| 
 | |
| Returns reference to hash of forwarding table MAC Addresses
 | |
| 
 | |
| (B<dot1dTpFdbAddress>)
 | |
| 
 | |
| =item $bridge->fw_port()
 | |
| 
 | |
| Returns reference to hash of forwarding table entries port interface
 | |
| identifier (iid)
 | |
| 
 | |
| (B<dot1dTpFdbPort>)
 | |
| 
 | |
| =item $bridge->fw_status()
 | |
| 
 | |
| Returns reference to hash of forwading table entries status
 | |
| 
 | |
| (B<dot2dTpFdbStatus>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Bridge Port Table (dot1dBasePortEntry)
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->bp_index()
 | |
| 
 | |
| Returns reference to hash of bridge port table entries map back to interface
 | |
| identifier (iid)
 | |
| 
 | |
| (B<dot1dBasePortIfIndex>)
 | |
| 
 | |
| =item $bridge->bp_port()
 | |
| 
 | |
| Returns reference to hash of bridge port table entries for a port which
 | |
| (potentially) has the same value of B<dot1dBasePortIfIndex> as another port
 | |
| on the same bridge, this object contains the name of an	object instance unique
 | |
| to this port.
 | |
| 
 | |
| (B<dot1dBasePortCircuit>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Spanning Tree Protocol Table (dot1dStpPortTable)
 | |
| 
 | |
| Descriptions are lifted straight from F<BRIDGE-MIB.my>
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->stp_p_id()
 | |
| 
 | |
| "The port number of the port for which this entry contains Spanning Tree
 | |
| Protocol management information."
 | |
| 
 | |
| (B<dot1dStpPort>)
 | |
| 
 | |
| =item $bridge->stp_p_priority()
 | |
| 
 | |
| "The value of the priority field which is contained in the first
 | |
| (in network byte order) octet of the (2 octet long) Port ID.  The other octet
 | |
| of the Port ID is given by the value of dot1dStpPort."
 | |
| 
 | |
| (B<dot1dStpPortPriority>)
 | |
| 
 | |
| =item $bridge->stp_p_state()
 | |
| 
 | |
| "The port's current state as defined by application of the Spanning Tree
 | |
| Protocol.  This state controls what action a port takes on reception of a
 | |
| frame.  If the bridge has detected a port that is malfunctioning it will place
 | |
| that port into the broken(6) state.  For ports which are disabled
 | |
| (see dot1dStpPortEnable), this object will have a value of disabled(1)."
 | |
| 
 | |
|  disabled(1)
 | |
|  blocking(2)
 | |
|  listening(3)
 | |
|  learning(4)
 | |
|  forwarding(5)
 | |
|  broken(6)
 | |
| 
 | |
| (B<dot1dStpPortState>)
 | |
| 
 | |
| =item $bridge->stp_p_cost()
 | |
| 
 | |
| "The contribution of this port to the path cost of paths towards the spanning
 | |
| tree root which include this port.  802.1D-1990 recommends that the default
 | |
| value of this parameter be in inverse proportion to the speed of the attached
 | |
| LAN."
 | |
| 
 | |
| (B<dot1dStpPortPathCost>)
 | |
| 
 | |
| =item $bridge->stp_p_root()
 | |
| 
 | |
| "The unique Bridge Identifier of the Bridge recorded as the Root in the
 | |
| Configuration BPDUs transmitted by the Designated Bridge for the segment to
 | |
| which the port is attached."
 | |
| 
 | |
| (B<dot1dStpPortDesignatedRoot>)
 | |
| 
 | |
| =item $bridge->stp_p_bridge()
 | |
| 
 | |
| "The Bridge Identifier of the bridge which this port considers to be the
 | |
| Designated Bridge for this port's segment."
 | |
| 
 | |
| (B<dot1dStpPortDesignatedBridge>)
 | |
| 
 | |
| =item $bridge->stp_p_port()
 | |
| 
 | |
| (B<dot1dStpPortDesignatedPort>)
 | |
| 
 | |
| "The Port Identifier of the port on the Designated Bridge for this port's
 | |
| segment."
 | |
| 
 | |
| =item $bridge->i_stp_port()
 | |
| 
 | |
| Returns the mapping of (B<dot1dStpPortDesignatedPort>) to the interface
 | |
| index (iid).
 | |
| 
 | |
| =item $bridge->i_stp_id()
 | |
| 
 | |
| Returns the mapping of (B<dot1dStpPort>) to the interface index (iid).
 | |
| 
 | |
| =item $bridge->i_stp_bridge()
 | |
| 
 | |
| Returns the mapping of (B<dot1dStpPortDesignatedBridge>) to the interface
 | |
| index (iid).
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Q-BRIDGE Port VLAN Table (dot1qPortVlanTable)
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->qb_i_vlan()
 | |
| 
 | |
| The PVID, the VLAN ID assigned to untagged frames or Priority-Tagged frames
 | |
| received on this port.
 | |
| 
 | |
| (B<dot1qPvid>)
 | |
| 
 | |
| =item $bridge->qb_i_vlan_type()
 | |
| 
 | |
| Either C<admitAll> or C<admitOnlyVlanTagged>.  This is a good spot to find
 | |
| trunk ports.
 | |
| 
 | |
| (B<dot1qPortAcceptableFrameTypes>)
 | |
| 
 | |
| =item $bridge->qb_i_vlan_in_flt()
 | |
| 
 | |
| When this is C<true> the device will discard incoming frames for VLANs which
 | |
| do not include this Port in its Member set.  When C<false>, the port will
 | |
| accept all incoming frames.
 | |
| 
 | |
| (B<dot1qPortIngressFiltering>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Q-BRIDGE VLAN Static Table (dot1qVlanStaticTable)
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->qb_v_name()
 | |
| 
 | |
| Human-entered name for vlans.
 | |
| 
 | |
| (B<dot1qVlanStaticName>)
 | |
| 
 | |
| =item $bridge->qb_v_egress()
 | |
| 
 | |
| The set of ports which are assigned to the egress list for this VLAN.
 | |
| 
 | |
| (B<dot1qVlanStaticEgressPorts>)
 | |
| 
 | |
| =item $bridge->qb_v_fbdn_egress()
 | |
| 
 | |
| The set of ports which are prohibited from being included in the egress list
 | |
| for this VLAN.
 | |
| 
 | |
| (B<dot1qVlanForbiddenEgressPorts>)
 | |
| 
 | |
| =item $bridge->qb_v_untagged()
 | |
| 
 | |
| The set of ports which should transmit egress packets for this VLAN as
 | |
| untagged. 
 | |
| 
 | |
| (B<dot1qVlanStaticUntaggedPorts>)
 | |
| 
 | |
| =item $bridge->qb_v_stat()
 | |
| 
 | |
| uhh. C<active> !
 | |
| 
 | |
| (B<dot1qVlanStaticRowStatus>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =head2 Q-BRIDGE Filtering Database Table (dot1qFdbTable)
 | |
| 
 | |
| =over
 | |
| 
 | |
| =item $bridge->qb_fw_mac()
 | |
| 
 | |
| Returns reference to hash of forwarding table MAC Addresses
 | |
| 
 | |
| (B<dot1qTpFdbAddress>)
 | |
| 
 | |
| =item $bridge->qb_fw_port()
 | |
| 
 | |
| Returns reference to hash of forwarding table entries port interface
 | |
| identifier (iid)
 | |
| 
 | |
| (B<dot1qTpFdbPort>)
 | |
| 
 | |
| =item $bridge->qb_fw_status()
 | |
| 
 | |
| Returns reference to hash of forwading table entries status
 | |
| 
 | |
| (B<dot1qTpFdbStatus>)
 | |
| 
 | |
| =back
 | |
| 
 | |
| =cut
 |