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 instead of sending a  wake  packet  to  all
32              interfaces.
33
34       -p passwd
35              Append  a  four  or  six byte password to the packet. Only a few
36              adapters need or support this. A six byte password may be speci‐
37              fied  in  Ethernet  hex  format (00:22:44:66:88:aa) or four byte
38              dotted decimal (192.168.1.1) format.  A four byte password  must
39              use the dotted decimal format.
40
41
42       -V     Show the program version information.
43
44

EXIT STATUS

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

SEE ALSO

54       arp(8).
55

SECURITY

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

AUTHOR

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