NAME Net::SNMP::Mixin::CiscoDot1qVlanStatic - mixin class for static Cisco vlan info VERSION Version 0.02 SYNOPSIS use Net::SNMP; use Net::SNMP::Mixin; # initialize session and mixin library my $session = Net::SNMP->session( -hostname => 'foo.bar.com' ); $session->mixer('Net::SNMP::Mixin::CiscoDot1qVlanStatic'); $session->init_mixins; snmp_dispatcher(); $session->init_ok(); die $session->errors if $session->errors; # show VLAN IDs and corresponding names my $id2name = $session - map_vlan_id2name(); foreach my $id ( keys %{$id2name} ) { printf "Vlan-Id: %4d => Vlan-Name: %s\n", $id, $id2name->{$id}; } # sorted by vlan_id my $vlan_ids2if_idx = $session->map_vlan_id2if_idx(); foreach my $id ( keys %{$vlan_ids2if_idx} ) { printf "Vlan-Id: %4d\n", $id; printf "\tTagged-Ports: %s\n", ( join ',', @{ $vlan_ids2if_idx->{$id}{tagged} } ); printf "\tUntagged-Ports: %s\n", ( join ',', @{ $vlan_ids2if_idx->{$id}{untagged} } ); } # sorted by interface my $ports2ids = $session->map_if_idx2vlan_id(); foreach my $if_idx ( keys %{$ports2ids} ) { printf "Interface: %10d\n", $if_idx; printf "\tTagged-Vlans: %s\n", ( join ',', @{ $ports2ids->{$if_idx}{tagged} } ); printf "\tUntagged-Vlans: %s\n", ( join ',', @{ $ports2ids->{$if_idx}{untagged} } ); } DESCRIPTION A mixin class for vlan related infos from the CISCO-VTP-MIB for 802.1Q-trunks and CISCO-VLAN-MEMBERSHIP-MIB for access ports. The mixin-module provides methods for mapping between vlan-ids and vlan-names und relations between interfaces and vlan-ids, tagged or untagged on these ports. MIXIN METHODS OBJ->map_vlan_id2name() Returns a hash reference with vlan-ids as keys and the corresponding vlan-names as values: { vlan_id => vlan_name, vlan_id => vlan_name, ... , } OBJ->map_vlan_id2if_idx() Returns a hash reference with the vlan-ids as keys and tagged and untagged if_idx as values: { vlan_id => { tagged => [if_idx, ..., ], untagged => [if_idx, ..., ], }, ... , } OBJ->map_if_idx2vlan_id() Returns a hash reference with the interfaces as keys and tagged and untagged vlan-ids as values: { if_idx => { tagged => [vlan_id, ..., ], untagged => [vlan_id, ..., ], }, ... , } INITIALIZATION OBJ->_init($reload) Fetch basic Vlan related SNMP values from the host. Don't call this method direct! PRIVATE METHODS Only for developers or maintainers. _fetch_vtp_vlan_tbl_entries($session) Fetch selected rows from vtpVlanTable during object initialization. _vtp_vlan_tbl_entries_cb($session) The callback for _fetch_vtp_vlan_tbl_entries. _fetch_vtp_vlan_trunk_port_tbl_entries($session) Fetch selected rows from vlanTrunkPortTable during object initialization. _vtp_vlan_trunk_port_tbl_entries_cb($session) The callback for _fetch_vtp_vlan_trunk_port_tbl_entries. _fetch_vm_membership_tbl_entries($session) Fetch selected rows from vmMembershipTable during object initialization. The table maybe empty if there is no switch port in access mode. _vm_membership_tbl_entries_cb($session) The callback for _fetch_vm_membership_tbl_entries. REQUIREMENTS Net::SNMP, Net::SNMP::Mixin BUGS, PATCHES & FIXES There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please submit a bug to the RT system (see link below). However, it would help greatly if you are able to pinpoint problems or even supply a patch. Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me by sending an email to gaissmai@cpan.org . RT: http://rt.cpan.org/Public/Dist/Display.html?Name=Net-SNMP-Mixin-CiscoDot1qVlanStatic AUTHOR Karl Gaissmaier COPYRIGHT & LICENSE Copyright 2020 Karl Gaissmaier, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.