1ETHER-WAKE(8) System Manager's Manual ETHER-WAKE(8)
2
3
4
6 ether-wake - A tool to send a Wake-On-LAN "Magic Packet"
7
9 ether-wake [options] Host-ID
10
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
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
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
54 arp(8).
55
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
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)