|
 |
1bf9a7d |
.\" Hey, EMACS: -*- nroff -*-
|
|
|
1bf9a7d |
.\" First parameter, NAME, should be all caps
|
|
|
1bf9a7d |
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
|
1bf9a7d |
.\" other parameters are allowed: see man(7), man(1)
|
|
 |
724487e |
.TH ETHER-WAKE 8 "March 31, 2003" "Scyld"
|
|
|
1bf9a7d |
.\" Please adjust this date whenever revising the manpage.
|
|
|
1bf9a7d |
.\"
|
|
|
1bf9a7d |
.\" Some roff macros, for reference:
|
|
|
1bf9a7d |
.\" .nh disable hyphenation
|
|
|
1bf9a7d |
.\" .hy enable hyphenation
|
|
|
1bf9a7d |
.\" .ad l left justify
|
|
|
1bf9a7d |
.\" .ad b justify to both left and right margins
|
|
|
1bf9a7d |
.\" .nf disable filling
|
|
|
1bf9a7d |
.\" .fi enable filling
|
|
|
1bf9a7d |
.\" .br insert line break
|
|
|
1bf9a7d |
.\" .sp <n> insert n+1 empty lines
|
|
|
1bf9a7d |
.\" for manpage-specific macros, see man(7)
|
|
|
1bf9a7d |
.SH NAME
|
|
|
724487e |
ether-wake \- A tool to send a Wake-On-LAN "Magic Packet"
|
|
|
1bf9a7d |
.SH SYNOPSIS
|
|
|
724487e |
.B ether-wake
|
|
|
1bf9a7d |
.RI [ options ] " Host-ID"
|
|
|
1bf9a7d |
.SH DESCRIPTION
|
|
|
1bf9a7d |
This manual page documents the usage of the
|
|
|
1bf9a7d |
.B ether-wake
|
|
|
1bf9a7d |
command.
|
|
|
1bf9a7d |
.PP
|
|
|
1bf9a7d |
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
|
|
63250dc |
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
|
|
|
1bf9a7d |
.\" respectively.
|
|
|
724487e |
\fBether-wake\fP is a program that generates and transmits a Wake-On-LAN
|
|
|
1bf9a7d |
(WOL) "Magic Packet", used for restarting machines that have been
|
|
|
1bf9a7d |
soft-powered-down (ACPI D3-warm state). It generates the standard
|
|
|
1bf9a7d |
AMD Magic Packet format, optionally with a password included. The
|
|
|
1bf9a7d |
single required parameter is a station (MAC) address or a host ID that can
|
|
|
1bf9a7d |
be translated to a MAC address by an
|
|
|
1bf9a7d |
.BR ethers (5)
|
|
|
1bf9a7d |
database specified in
|
|
|
1bf9a7d |
.BR nsswitch.conf (5)
|
|
|
1bf9a7d |
.
|
|
|
1bf9a7d |
.SH OPTIONS
|
|
|
724487e |
\fBether-wake\fP needs a single dash (´-´) in front of options.
|
|
|
1bf9a7d |
A summary of options is included below.
|
|
|
1bf9a7d |
.TP
|
|
|
1bf9a7d |
.B \-b
|
|
|
1bf9a7d |
Send the wake-up packet to the broadcast address.
|
|
|
1bf9a7d |
.TP
|
|
|
1bf9a7d |
.B \-D
|
|
|
1bf9a7d |
Increase the Debug Level.
|
|
|
1bf9a7d |
.TP
|
|
|
1bf9a7d |
.B \-i ifname
|
|
|
1bf9a7d |
Use interface ifname instead of the default "eth0".
|
|
|
1bf9a7d |
.TP
|
|
|
1bf9a7d |
.B \-p passwd
|
|
|
1bf9a7d |
Append a four or six byte password to the packet. Only a few adapters
|
|
|
1bf9a7d |
need or support this. A six byte password may be specified in Ethernet hex
|
|
|
1bf9a7d |
format (00:22:44:66:88:aa) or four byte dotted decimal (192.168.1.1) format.
|
|
|
1bf9a7d |
A four byte password must use the dotted decimal format.
|
|
|
1bf9a7d |
|
|
|
1bf9a7d |
.TP
|
|
|
1bf9a7d |
.B \-V
|
|
|
1bf9a7d |
Show the program version information.
|
|
|
1bf9a7d |
|
|
|
1bf9a7d |
.SH EXIT STATUS
|
|
|
1bf9a7d |
This program returns 0 on success.
|
|
|
1bf9a7d |
A permission failures (e.g. run as a non-root user) results in an exit
|
|
|
1bf9a7d |
status of 2. Unrecognized or invalid parameters result in an exit
|
|
|
1bf9a7d |
status of 3. Failure to retrieve network interface information or send
|
|
|
1bf9a7d |
a packet will result in an exit status of 1.
|
|
|
1bf9a7d |
|
|
|
1bf9a7d |
.SH SEE ALSO
|
|
|
1bf9a7d |
.BR arp (8).
|
|
|
1bf9a7d |
.br
|
|
|
1bf9a7d |
.SH SECURITY
|
|
|
1bf9a7d |
On some non-Linux systems dropping root capability allows the process to be
|
|
|
1bf9a7d |
dumped, traced or debugged.
|
|
|
1bf9a7d |
If someone traces this program, they get control of a raw socket.
|
|
|
1bf9a7d |
Linux handles this safely, but beware when porting this program.
|
|
|
1bf9a7d |
.SH AUTHOR
|
|
|
63250dc |
The ether-wake program was written by Donald Becker at Scyld Computing
|
|
|
1bf9a7d |
Corporation for use with the Scyld(\*(Tm) Beowulf System.
|