NAME

       powerwake - smart utilty for remotely waking sleeping systems

SYNOPSIS

       powerwake [-b|--broadcast BROADCAST_IP] [-m|--method METHOD] TARGET_MAC|TARGET_IP|TARGET_HOST

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)