---
name: "SNMP::Info::PowerEthernet"
section: "3pm"
platform: "linux"
package: "libsnmp-info-perl"
version: "3.972002-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SNMP::Info::PowerEthernet"
---

# SNMP::Info::PowerEthernet(3pm)

SNMP Interface to data stored in POWER-ETHERNET-MIB.

## NAME

SNMP::Info::PowerEthernet - SNMP Interface to data stored in POWER-ETHERNET-MIB.

## AUTHOR

Bill Fenner

## 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";
```

## DESCRIPTION

*POWER-ETHERNET-MIB* is used to describe PoE (IEEE 802.3af)

Create or use a device subclass that inherit this class.  Do not use directly.

For debugging purposes you can call this class directly as you would SNMP::Info

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

### Inherited Classes

none.

### Required MIBs

- *POWER-ETHERNET-MIB*

  ## GLOBALS

none.

## TABLE METHODS

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

### Power Port Table

Selected values from the `"pethPsePortTable"`

- $poe-\>**peth\_port\_admin()**

  Administrative status: is this port permitted to deliver power?

  `"pethPsePortAdminEnable"`

- $poe-\>**peth\_port\_status()**

  Current status: is this port delivering power, searching, disabled, etc?

  `"pethPsePortDetectionStatus"`

- $poe-\>**peth\_port\_class()**

  Device class: if status is delivering power, this represents the 802.3af class of the device being powered.

  `"pethPsePortPowerClassifications"`

- $poe-\>**peth\_port\_ifindex()**

  A mapping function from the `"pethPsePortTable"` INDEX of module.port to an `"ifIndex"`.  The default mapping ignores the module (returning undef if there are any module values greater than 1) and returns the port number, assuming that there is a 1:1 mapping.

  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., see 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 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.

  `"pethMainPsePower"`

- $poe-\>**peth\_power\_status()**

  The power supply's operational status.

  `"pethMainPseOperStatus"`

- $poe-\>**peth\_power\_consumption()**

  How much power, in watts, this power supply has been committed to deliver.  (Note: certain devices seem to supply this value in milliwatts, so be cautious interpreting it.)

  `"pethMainPseConsumptionPower"`

- $poe-\>**peth\_power\_threshold()**

  The threshold (in percent) of consumption required to raise an alarm.

  `"pethMainPseUsageThreshold"`