LinuxCommandLibrary

etherwake

TLDR

Wake computer by MAC address

$ sudo etherwake [00:11:22:33:44:55]
copy
Wake using specific interface
$ sudo etherwake -i [eth0] [00:11:22:33:44:55]
copy
Wake with broadcast
$ sudo etherwake -b [00:11:22:33:44:55]
copy
Wake with password
$ sudo etherwake -p [password] [00:11:22:33:44:55]
copy
Debug mode
$ sudo etherwake -D [00:11:22:33:44:55]
copy

SYNOPSIS

etherwake [options] mac-address

DESCRIPTION

etherwake sends Wake-on-LAN (WoL) magic packets to wake computers from sleep, hibernation, or powered-off state. The target computer must have WoL enabled in BIOS/UEFI and on the network interface.
The magic packet contains a sync stream followed by the target MAC address repeated 16 times. When the network card detects this pattern, it signals the computer to power on.

PARAMETERS

-i interface

Network interface to use.
-b
Use broadcast address.
-D
Debug mode; show packet contents.
-p password
SecureOn password (6 bytes).
-V
Show version.
mac-address
Target MAC address (XX:XX:XX:XX:XX:XX).

REQUIREMENTS

- Target must have WoL enabled in BIOS/UEFI
- Network interface must support WoL
- Target must be on same network segment (or use directed broadcast)
- Target's NIC must have power in standby

CAVEATS

Requires root or CAPNETRAW capability. Works on local network only; WoL over internet needs port forwarding or VPN. Some NICs need specific driver configuration. Wireless usually doesn't support WoL.

HISTORY

Wake-on-LAN was developed in 1996 by AMD and HP as part of the Advanced Manageability Alliance. etherwake is one of several Linux implementations of WoL sending tools.

SEE ALSO

wol(1), wakeonlan(1), ethtool(8)

Copied to clipboard