NAME

       etherwake - A tool to send a Wake-On-LAN "Magic Packet"

SYNOPSIS

       etherwake [options] Host-ID

DESCRIPTION

       This manual page documents the usage of the ether-wake command.

       etherwake  is  a  program  that  generates  and  transmits  a  Wake-On-LAN (WOL) "Magic Packet", used for
       restarting machines that have been soft-powered-down (ACPI D3-warm state). It generates the standard  AMD
       Magic  Packet  format,  optionally  with a password included.  The single required parameter is a station
       (MAC) address or a host ID that can be translated to a MAC address by an ethers(5) database specified  in
       nsswitch.conf(5)

OPTIONS

       etherwake needs a single dash ('-') in front of options.  A summary of options is included below.

       -b     Send the 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 a few adapters need or support this. A six
              byte password may be specified in Ethernet hex format  (00:22:44:66:88:aa)  or  four  byte  dotted
              decimal (192.168.1.1) format.  A four byte password must use the dotted decimal format.

       -V     Show the program version information.

EXIT STATUS

       This  program  returns  0  on success.  A permission failures (e.g. run as a non-root user) results in an
       exit status of 2.  Unrecognized or invalid parameters result in an exit status of 3.  Failure to retrieve
       network interface information or send a packet will result in an exit status of 1.

SEE ALSO

       arp(8).

SECURITY

       On some non-Linux 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 program was written by Donald Becker at  Scyld  Computing  Corporation  for  use  with  the
       Scyld(™) Beowulf System.

Scyld                                            March 31, 2003                                     ETHERWAKE(8)