|
|
NasControl: New file releases version 1.2.0.0
09-30-2008
|
|
ETHER-WAKE(8) System Manager's Manual ETHER-WAKE(8) NAME
ether-wake - A tool to send a Wake-On-LAN "Magic Packet" SYNOPSIS
ether-wake [options] Host-ID DESCRIPTION
This manual page documents the usage of the ether-wake command. ether-wake 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
ether-wake 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 sending a wake packet to all interfaces. -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 ether-wake program was written by Donald Becker at Scyld Computing Corporation for use with the Scyld(tm) Beowulf System. Scyld March 31, 2003 ETHER-WAKE(8)