SNMP::...Huawei(3pm)

✨ NAME ✨

Okay bestie, gather round 💖 this page is SNMP::Info::Layer3::Huawei — your SNMP interface to Huawei switches and routers. It lives in the User Contributed Perl Documentation, and the man page name is SNMP::...Huawei(3pm), iykyk 🎀

👑 AUTHORS 👑

Jeroen van Ingen and Eric Miller. Absolute icons, no cap 💅

🦋 SYNOPSIS 🦋

The vibe is: you let SNMP::Info figure out which subclass you actually need, and it just knows 🧚

 # 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 🌸

It's the subclass for Huawei switches, periodt ✨

💜 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, okurrr 💅

• $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.

---

and that's the whole page, bestie 🫶 this one's running on perl v5.40.1, dated 2026-02-28, from the SNMP::...Huawei(3pm) manual. go read your switch, slay 💅✨