Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SNMP::Info::PowerEtherUser3Contributed Perl DocumeSNMP::Info::PowerEthernet(3)

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"

perl v5.32.0			  2020-08-09	  SNMP::Info::PowerEthernet(3)

NAME | AUTHOR | SYNOPSIS | DESCRIPTION | GLOBALS | TABLE METHODS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SNMP::Info::PowerEthernet&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help