ETHERWAKE(8)                                                                                                                                 ETHERWAKE(8)

NAME
       etherwake - A tool to send magic WOL packages

SYNOPSIS
       etherwake [options] MAC-Address

DESCRIPTION
       This manual page documents briefly the etherwake commands.

       etherwake  is  a  program that generates and transmits Wake-On-LAN (WOL) "Magic Packet", used for restarting machines that have been soft-powered-
       down (ACPI D3-warm state). It currently generates the standard AMD Magic Packet format, with an optional password appended.

OPTIONS
       etherwake needs a single dash (?-?) in front of the option.  A summary of options is included below.

       -b     Send wake-up packet to the broadcast address.

       -D     Increase the Debug Level.

       -i ifname
              Use interface ifname instead of the default "eth0".

       -p passwd
              Append a four or six byte password to the packet. Only very few adapters need or support this. The password may be also specified in ether-
              net hex format (00:22:44:66:88:aa) or dotted decimal (192.168.1.1).

SEE ALSO
       arp(8).

KNOWN BUGS
       On some systems dropping root capability allows the process to be dumped, traced or debugged.  If someone traces this program, they get control of
       a raw socket.  Linux handles this safely, but beware when porting this program.

AUTHOR
       The etherwake was written by Donald Becker <becker@scyld.com> at Scyld Computing Corporation.  This manual page was formatted by  Alain  Schroeder
       <alain@parkautomat.net> from the on-line manual in the program.

                                                                      June 06, 2003                                                          ETHERWAKE(8)