ETHER-WAKE(8)                                                    ETHER-WAKE(8)

NAME

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

SYNOPSIS

       ether-wake [options] Host-ID

DESCRIPTION

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

       ether-wake  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  nss-
       witch.conf(5)

OPTIONS

       ether-wake 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 speci-
              fied 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((TM)) Beowulf System.

Scyld                           March 31, 2003                   ETHER-WAKE(8)