ETHER\-WAKE

NAME

ether-wake - A tool to send magic WOL packages

SYNOPSIS

ether-wake [options] MAC-Address

DESCRIPTION

This manual page documents briefly the ether-wake commands.

ether-wake is a program that generates and transmits Wake-On-LAN (WOL) "Magic Packet", used for restarting machines that have been soft-powered-down (ACPI D3-warm state). It currently generates the standard AMD Magic Packet format, with an optional password appended.

OPTIONS

ether-wake needs a single dash (´-´) in front of the option. A summary of options is included below.

-b: Send 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 very few adapters need or support this. The password may be also specified in ethernet hex format (00:22:44:66:88:aa) or dotted decimal (192.168.1.1).

KNOWN BUGS

On some 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 ether-wake program was written by Donald Becker at Scyld Computing Corporation. This manual page was formatted by Alain Schroeder <alain@mini.gt.owl.de> from the on-line manual in the program.