huschi.net

ETHER-WAKE(8)               System Manager's Manual              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 sending a  wake  packet  to  all
              interfaces.
       -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 ether-wake 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)