OPTIONS

-b|--broadcast BROADCAST_IP

Optional parameter specifying the broadcast ip. If unspecified, the default is 255.255.255.255.

-m|--method METHOD

Currently, 'wol' is the only supported method.

TARGET_MAC|TARGET_IP|TARGET_HOST

The target system to powerwake may be identified by MAC address, or by an IP/hostname cached in (the current arp(8) table, /etc/ethers, /var/cache/powerwake/ethers).

DESCRIPTION

The powerwake utility compliments the powernap(8) daemon. Administrators can run the powernap utility on remote hosts, allowing them to sleep when un-utilitized. To awake the remote system, use powerwake.

Powerwake is designed to be "smart", and support multiple methods of waking remote hosts, such as wakeonlan, ipmi, and others. Currently, wakeonlan is the only implemented mechanism, though others are intended.

Powerwake is also "smart" in that it can take MAC address, hostnames, or ip addresses. In the case of a hostname or ip address, powerwake will first load a dynamically maintained cache file /var/cache/powerwake/ethers, then a statically administered configuration file /etc/ethers, and finally use the arp table to determine the target MAC address. The cache will be updated accordingly.

http://launchpad.net/powernap

FILES

/etc/ethers, /var/cache/powerwake/ethers

SEE ALSO

arp(8)

AUTHOR

This manpage and the utility was written by Dustin Kirkland <kirkland@canonical.com> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

powerwake 26 Jun 2009 powerwake(1)