Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

APCPWR(8)		  BSD System Manager's Manual		     APCPWR(8)

NAME
     apcpwr — control power on/off/reboot via an APC MasterSwitch

SYNOPSIS
     apcpwr list
     apcpwr probe
     apcpwr [-f] on outletname
     apcpwr [-f] off outletname
     apcpwr [-f] reboot outletname

DESCRIPTION
     The apcpwr utility is used to control power to systems connected to an
     APC MasterSwitch power distribution unit.	The following option is avail‐
     able for script usage:

     -f	 Force the operation to occur without asking for final confirmation
	 before execution.

COMMANDS
     The commands recognized by apcpwr are as follows:

     list    produces a list of the known APC MasterSwitches and the informa‐
	     tion associated with each port. The outlet status is dynamically
	     determined via snmp request each time the list command is exe‐
	     cuted.

     probe   produces the .db file (default: /var/db/apcpwr.db ).

     on	     turns on the output specified by outletname

     off     turns off the output specified by outletname

     reboot  turns off the outlet specified by outletname for (a default of) 5
	     seconds and then turns it back on.

EXAMPLES
     The following command:

     apcpwr list

     produces a table listing all managed MasterSwitch units, the device name
     attached to each outlet, and it's status.

     pdu1 (172.21.251.251)
	1: triangle			    On
	2: 8ball			    On
	3: 9ball			    On
	4: cueball			    On
	5: avail-5			    On
	6: avail-6			    On
	7: avail-7			    On
	8: admin			    On

     apcpwr reboot admin

     will turn off power for the system attached to pdu1, outlet 8, for (a
     default of) 5 seconds, and then automatically turn the power back on.
     Since the -f option was not specified, the following text:

	   Are you sure? [y|N]:

     will be printed to standard output and a positive response required
     before the operation will continue.

     apcpwr probe

     A sample /etc/crontab entry to build the .db file via the probe command
     is:

     #
     # Create /var/db/apcpwr.db
     #
     0	     21	     *	     *	     *	     root    /usr/local/bin/apcpwr probe > /dev/null

FILES
     /usr/local/etc/apcpwr.conf
     /var/db/apcpwr.db

SEE ALSO
     snmpwalk(8), snmpget(8), snmpset(8)

CAVEATS
     These utilities are based upon the netsnmp port. Other snmp packages may
     work but are untested.

     The MIB file POWERNET344_MIB.txt is not required to use this port. How‐
     ever, if you with to debug this utility it must be copied from the pro‐
     vided media CD which came with the unit and installed into the correct
     MIB directory (in this instance: /usr/local/share/snmp/mibs).

BSD				 April 1, 2003				   BSD

Vote for polarhome