Imported Upstream version 2.6.2

2011-09-29 20:14:46 +02:00 · 2011-09-29 20:14:46 +02:00 · 45043b58d0
commit 45043b58d0
parent a367d9bc54
246 changed files with 18228 additions and 1415 deletions
--- a/docs/man/nut-ipmipsu.txt
+++ b/docs/man/nut-ipmipsu.txt
@ -0,0 +1,115 @@
+NUT-IPMIPSU(8) 
+==============
+
+NAME
+----
+
+nut-ipmipsu - Driver for IPMI Power Supply Units (PSU)
+
+SYNOPSIS
+--------
+
+*nut-ipmipsu* -h
+
+*nut-ipmipsu* -a 'PSU_NAME' ['OPTIONS']
+
+NOTE: This driver is experimental, and still a work-in-progress. Feedback is
+encouraged.
+
+NOTE: This man page only documents the hardware-specific features of the
+nut-ipmipsu driver.  For information about the core driver, see
+linkman:nutupsdrv[8].
+
+SUPPORTED HARDWARE
+------------------
+
+This driver should support a wide range of PSUs through local IPMI interface.
+
+nut-ipmipsu currently use the GNU FreeIPMI project, for IPMI implementation.
+
+
+EXTRA ARGUMENTS
+---------------
+
+This driver doesn't support any optional settings.
+
+INSTALLATION
+------------
+
+This driver is not built by default.  You can build it by using
+"configure --with-ipmi=yes".
+
+You also need to give proper permissions on the local IPMI device file
+(/dev/ipmi0 for example) to allow the NUT user to access it.
+
+An udev rules file (nut-ipmipsu.rules) is provided and automatically installed
+on udev enabled system. This file is generally installed in /etc/udev/rules.d/
+or /lib/udev/rules.d/ on newer systems, to address the permission settings
+problem. For more information, refer to nut/scripts/udev/README.
+
+INSTANT COMMANDS
+----------------
+
+This driver doesn't support any instant commands.
+
+IMPLEMENTATION
+--------------
+
+The "port" value is used to identify the PSU.  For instance, to target
+FRU 0x2, use the following in *ups.conf*:
+
+	[pdu]
+		driver = nut-ipmipsu
+		port = id2
+
+This driver will report various information related to a PSU, including:
+
+ - manufacturer, model, serial and part numbers,
+ - nominal voltage and frequency,
+ - actual current and voltage,
+ - status of the PSU:
+
+   * 'OL' means that the PSU is present and providing power,
+   * 'OB' means that the PSU is present but not providing power (power cable removed),
+   * 'stale' means that the PSU is not present (ie physically removed).
+
+Here is an example output for a Dell r610 server:
+
+	device.mfr: DELL
+	device.mfr.date: 01/05/11 - 08:51:00
+	device.model: PWR SPLY,717W,RDNT
+	device.part: 0RN442A01
+	device.serial: CN179721130031
+	device.type: psu
+	driver.name: nut-ipmipsu
+	driver.parameter.pollinterval: 2
+	driver.parameter.port: id2
+	driver.version: 2.6.1-3139M
+	driver.version.data: IPMI PSU driver
+	driver.version.internal: 0.01
+	input.current: 0.20
+	input.frequency.high: 63
+	input.frequency.low: 47
+	input.voltage: 232.00
+	input.voltage.maximum: 264
+	input.voltage.minimum: 90
+	ups.id: 2
+	ups.realpower.nominal: 717
+	ups.status: OL
+	ups.voltage: 12
+
+AUTHOR
+------
+Arnaud Quette <arnaud.quette@free.fr>
+
+SEE ALSO
+--------
+The core driver:
+~~~~~~~~~~~~~~~~
+linkman:nutupsdrv[8]
+
+Internet resources:
+~~~~~~~~~~~~~~~~~~~
+The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
+
+GNU FreeIPMI home page: http://www.gnu.org/software/freeipmi/