debian man page for etherwake

Query: etherwake

OS: debian

Section: 8

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

ETHERWAKE(8)						      System Manager's Manual						      ETHERWAKE(8)

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. Scyld March 31, 2003 ETHERWAKE(8)
Related Man Pages
srp-gen(1) - debian
edge(8) - debian
etherwake(8) - debian
wol(1) - suse
rarpd(8) - osf1
Similar Topics in the Unix Linux Community
rhel 4 linux WOL wake on lan
Trouble Configuring Wake On Lan