SNMP::...thernet(3pm)

✨ NAME ✨

SNMP::Info::PowerEthernet — the SNMP bestie that talks to all the data chillin' in POWER-ETHERNET-MIB. 💖

(also, the manual page header calls this thing SNMP::...thernet(3pm), and it lives in the User Contributed Perl Documentation section, iykyk 🫶)

👑 AUTHOR 👑

Bill Fenner wrote this. iconic of him, honestly. 💅

---

🎀 SYNOPSIS 🎀

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

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

like, you literally just let it pick its own subclass and it tells you what it picked. main character behavior fr fr. 🌟

---

🌸 DESCRIPTION 🌸

POWER-ETHERNET-MIB is the MIB that describes PoE — that's IEEE 802.3af, bestie, the thing that sends power down the ethernet cable so your access point doesn't need its own lil wall wart. ⚡💖

⚠️ ok so listen: create or use a device subclass that inherits this class. Do not use it directly. this is the blueprint, not the house. 🏠

For debugging purposes you can call this class directly the same way you'd call SNMP::Info:

my $poe = new SNMP::Info::PowerEthernet (...);

🦋 Inherited Classes 🦋

none. it's giving self-made. 💀

🎀 Required MIBs 🎀

POWER-ETHERNET-MIB

---

💜 GLOBALS 💜

none. nothing here. empty. a vacuum. 🌈

---

💅 TABLE METHODS 💅

These are methods that return tables of information in the form of a reference to a hash. (yes bestie, a hashref. get into it. 🍓)

⭐ Power Port Table ⭐

Selected values from the "pethPsePortTable" — the lil table about ports that might get to hand out power. 👑

• $poe->peth_port_admin() — administrative status: is this port, like, permitted to deliver power? yes or no energy.
  • maps to "pethPsePortAdminEnable"
• $poe->peth_port_status() — current status: is this port delivering power, searching, disabled, etc? the vibe check of the port, basically.
  • maps to "pethPsePortDetectionStatus"
• $poe->peth_port_class() — device class: if status is delivering power, this represents the 802.3af class of the device being powered.
  • maps to "pethPsePortPowerClassifications"
• $poe->peth_port_ifindex() — a mapping function from the "pethPsePortTable" INDEX of module.port to an "ifIndex". The default mapping ignores the module — it returns undef if there are any module values greater than 1 — and just returns the port number, assuming there's a 1:1 mapping.
  • ngl, this mapping is more or less left up to the device vendor to implement; the MIB gives only very weak guidance. a given device class may implement its own version of this function (e.g. go peek at Info::CiscoPower). 🙈
• $poe->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, but it may be overridden by a subclass that has information from another source (e.g. if a different protocol, such as CDP, was used to negotiate the power level). ✨

🌈 Power Supply Table 🌈

• $poe->peth_power_watts() — the power supply's capacity, in watts.
  • maps to "pethMainPsePower"
• $poe->peth_power_status() — the power supply's operational status.
  • maps to "pethMainPseOperStatus"
• $poe->peth_power_consumption() — how much power, in watts, this power supply has been committed to deliver.
  • maps to "pethMainPseConsumptionPower"
  • > 😭 heads up: certain devices seem to supply this value in milliwatts instead, so be cautious interpreting it. stay safe out there.
• $poe->peth_power_threshold() — the threshold (in percent) of consumption required to raise an alarm.
  • maps to "pethMainPseUsageThreshold"

---

and that's the whole page, bestie. go forth and poll responsibly. 💜✨

~( ˶ˆᗜˆ˵ ) this lil writeup came from perl v5.40.1, dated 2026-02-28, and yeah it's still filed under SNMP::...thernet(3pm) — the truncation is real but so is my love for you. mwah. 🫶💖~