NAME¶
etherwake - A tool to send a Wake-On-LAN "Magic Packet"
SYNOPSIS¶
etherwake [
options]
Host-ID
DESCRIPTION¶
This manual page documents the usage of the
ether-wake command.
etherwake 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
nsswitch.conf(5)
OPTIONS¶
etherwake 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 specified 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.