1ETHER-WAKE(8)               System Manager's Manual              ETHER-WAKE(8)
2
3
4

NAME

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

SYNOPSIS

9       ether-wake [options] Host-ID
10

DESCRIPTION

12       This manual page documents the usage of the ether-wake command.
13
14       ether-wake  is  a  program  that  generates and transmits a Wake-On-LAN
15       (WOL) "Magic Packet", used for restarting machines that have been soft-
16       powered-down  (ACPI D3-warm state). It generates the standard AMD Magic
17       Packet  format,  optionally  with  a  password  included.   The  single
18       required  parameter is a station (MAC) address or a host ID that can be
19       translated to a MAC address by an ethers(5) database specified in  nss‐
20       witch.conf(5)
21

OPTIONS

23       ether-wake needs a single dash (´-´) in front of options.  A summary of
24       options is included below.
25
26       -b     Send the wake-up packet to the broadcast address.
27
28       -D     Increase the Debug Level.
29
30       -i ifname
31              Use interface ifname.
32
33       -p passwd
34              Append a four or six byte password to the  packet.  Only  a  few
35              adapters need or support this. A six byte password may be speci‐
36              fied in Ethernet hex format  (00:22:44:66:88:aa)  or  four  byte
37              dotted  decimal (192.168.1.1) format.  A four byte password must
38              use the dotted decimal format.
39
40
41       -V     Show the program version information.
42
43

EXIT STATUS

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

SEE ALSO

53       arp(8).
54

SECURITY

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

AUTHOR

62       The  etherwake  program was written by Donald Becker at Scyld Computing
63       Corporation for use with the Scyld(™) Beowulf System.
64
65
66
67Scyld                           March 31, 2003                   ETHER-WAKE(8)
Impressum