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.