NAME

       SNMP::Info::Layer3::Huawei - SNMP Interface to Huawei switches and routers.

AUTHORS

       Jeroen van Ingen and Eric Miller

SYNOPSIS

        # Let SNMP::Info determine the correct subclass for you.
        my $huawei = new SNMP::Info(
                                 AutoSpecify => 1,
                                 Debug       => 1,
                                 DestHost    => 'myrouter',
                                 Community   => 'public',
                                 Version     => 2
                               )
           or die "Can't connect to DestHost.\n";

        my $class      = $huawei->class();
        print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION

       Subclass for Huawei switches

   Inherited Classes
       SNMP::Info::Layer3
       SNMP::Info::IEEE802dot3ad

   Required MIBs
       HUAWEI-MIB
       HUAWEI-PORT-MIB
       HUAWEI-IF-EXT-MIB
       HUAWEI-L2IF-MIB
       HUAWEI-POE-MIB
       HUAWEI-ENTITY-EXTENT-MIB
       Inherited Classes' MIBs
           See SNMP::Info::Layer3 for its own MIB requirements.

           See SNMP::Info::IEEE802dot3ad for its own MIB requirements.

GLOBALS

       These are methods that return scalar value from SNMP

       $huawei->vendor()
           Returns 'huawei'.

       $huawei->os()
           Returns 'VRP' if contained in "sysDescr", 'huawei' otherwise.

       $huawei->os_ver()
           Returns the software version derived from the "ENTITY-MIB" or extracted from "sysDescr".

       $huawei->mac()
           Base MAC of the device.

           ("dot1dBaseBridgeAddress")

       $huawei->fan()
           Return  the  status  of  all  fans from the HUAWEI-ENTITY-EXTENT-MIB. Returns a string indicating the
           number of fans 'OK' or identification of any fan without a 'normal' operating status

       $huawei->ps1_status()
           Return the status of the first power supply in each chassis or switch from the  HUAWEI-ENTITY-EXTENT-
           MIB

       $huawei->ps2_status()
           Return the status of the second power supply in each chassis or switch from the HUAWEI-ENTITY-EXTENT-
           MIB

   Globals imported from SNMP::Info::Layer3
       See documentation in SNMP::Info::Layer3 for details.

TABLE ENTRIES

       These are methods that return tables of information in the form of a reference to a hash.

       $huawei->i_duplex()
           Returns reference to map of IIDs to current link duplex.

       $huawei->i_duplex_admin()
           Returns reference to hash of IIDs to admin duplex setting.

   POE Slot Table
       $huawei->peth_power_watts()
           The slot's power supply's capacity, in watts.

           "hwPoeSlotMaximumPower"

       $huawei->peth_power_consumption()
           How much power, in watts, this power supply has been committed to deliver.

           "hwPoeSlotConsumingPower"

       $huawei->peth_power_threshold()
           The threshold (in percent) of consumption required to raise an alarm.

           "hwPoeSlotPowerUtilizationThreshold"

   Overrides
       $huawei->i_ignore()
           Returns reference to hash.  Increments value of IID if port is to be ignored.

           Ignores InLoopback and Console interfaces

       $huawei->bp_index()
           Returns  a  mapping  between  "ifIndex"  and  the Bridge Table. Uses "hwL2IfPortIfIndex" for the most
           complete mapping and falls back to "dot1dBasePortIfIndex" if not available.

       "agg_ports"
           Returns a HASH reference mapping from slave to master port for each member of a port  bundle  on  the
           device.  Keys  are  ifIndex of the slave ports, Values are ifIndex of the corresponding master ports.
           Attempts to use "hwTrunkIfTable" first and then "dot3adAggPortListPorts" if that is unavailable.

       "i_mtu"
           Interface    MTU    value.    Overridden    with    corresponding    frame    size     entry     from
           "hwEthernetJumboframeMaxLength" if one exists.

   Power Port Table
       The  index  of these methods have been normalized to slot.port and values munged to provide compatibility
       with the IEEE 802.3af POWER-ETHERNET-MIB and equivalent SNMP::Info::PowerEthernet methods.

       $huawei->peth_port_admin()
           Administrative status: is this port permitted to deliver power?

       $huawei->peth_port_status()
           Current status: is this port delivering power, searching, disabled, etc?

       $huawei->peth_port_class()
           Device class: if status is delivering power, this represents the 802.3af class of  the  device  being
           powered.

       $huawei->peth_port_power()
           Power supplied the port, in milliwatts

       $huawei->peth_port_ifindex()
           Returns  an index of slot.port to an "ifIndex". Slot defaults to zero meaning chassis or box if there
           is no "ifIndex" to slot mapping available in "hwPhysicalPortInSlot". Mapping the index  to  slot.port
           is a normalization function to provide compatibility with the IEEE 802.3af POWER-ETHERNET-MIB.

       $huawei->peth_port_neg_power()
           The  power,  in  milliwatts,  that  has  been committed to this port.  This value is derived from the
           802.3af class of the device being powered.

   Table Methods imported from SNMP::Info::Layer3
       See documentation in SNMP::Info::Layer3 for details.

   Table Methods imported from SNMP::Info::IEEE802dot3ad
       See documentation in SNMP::Info::IEEE802dot3ad for details.

Data Munging Callback Subroutines

       $huawei->munge_hw_peth_admin()
           Normalizes "hwPoePortEnable" values to 'true' or 'false'.

       $huawei->munge_hw_peth_class()
           Normalizes "hwPoePortPdClass" values by prepending 'class'.

       $huawei->munge_hw_peth_power()
           Converts and rounds to a whole number milliwatts to watts.

       $huawei->munge_hw_peth_status()
           Normalizes "hwPoePortPowerStatus" values to those that would be returned  by  the  the  IEEE  802.3af
           POWER-ETHERNET-MIB.

perl v5.40.0                                       2024-11-09                    SNMP::Info::Layer3::Huawei(3pm)