Wakeonlan

José Pedro Oliveira <`jpo at di.uminho.pt`>

v0.11, 2005-07-26

This is now the new homepage of the Wakeonlan script. Previous versions can still be downloaded from the original author homepage.

1. What is it?

Wakeonlan is a Perl script that sends 'magic packets' to wake-on-LAN enabled ethernet adapters and motherboards, in order to switch on remote computers.

See this mini-HOWTO for more information about this technology. Still under development ....

2. Downloads

Author GPG public key

gpg key (fingerprint: F9B6 8D87 859D 1C94 48F0 84C0 9749 9EB5 91BD 851B)

Wakeonlan:

wakeonlan-0.41.tar.gz ( md5 )
Signed RPMS: wakeonlan-0.41-0.fdr.1.noarch.rpm, wakeonlan-0.41-0.fdr.1.src.rpm.
wakeonlan-0.40.tar.gz ( md5 ).
Previous versions available in the original author website.

3. Installation

Choose one of the following methods:

Simply extract the Perl script wakeonlan from the archive file.
From version 0.40 onwards you can just follow standard CPAN procedures:
- tar zxvf wakeonlan-0.41.tar.gz
- cd wakeonlan-0.41
- cpansign -v (optional step; requires Module::Signature)
- perl Makefile.PL
- make
- make install
Using RPM. Should work in every rpm based Linux distro.
- rpm -ivh http://gsd.di.uminho.pt/jpo/software/wakeonlan/downloads/wakeonlan-0.41-0.fdr.1.noarch.rpm

4. ChangeLog

Version 0.41 (2005-01-27) - Minor documentation updates/corrections.
Version 0.40 (2000-08-01) - New command line parameters. Ability to load ethernet addresses from a file.

5. Platforms

This script was tested on the following Intel platforms:

Linux Red Hat 6.2 + Perl 5.005_03
Linux Red Hat 7.0 + Perl 5.6.0 and 5.7.1
Linux Red Hat 7.3 + Perl 5.6.1
Linux Fedora Core 3 + Perl 5.8.5
Linux Fedora Core 4 + Perl 5.8.6
Windows 9x, Windows NT/2000/XP/2003 + ActivePerl

This script should work in every platform supported by Perl (just check the perlport documentation page).

6. Known problems/limitations

This script only sends 'magic packets' in UDP packets.

7. Wish list/future work

Build an ethernet frame to send magic packets (as in Donald Becker's ether-wake program). Requires additional privileges: root or CAP_NET_RAW capability.
Extract hardware addresses from ISC DHCP server configuration files
Extract hardware addresses from ARP tables
Extract hardware addresses from ARPWATCH databases
Extract hardware addresses from Rembo configuration files (groups of hosts)

8. Author

José Pedro Oliveira <jpo at di.uminho.pt> maintaining and expanding original work done by Ico Doornekamp <ico at edd.dhs.org>

Comments, suggestions and bug reports are welcome. Just send them to the current maintainer.

9. Copyright

This module is free software. It may be used, redistributed and/or modified under the terms of the Perl Artistic License (see http://www.perl.com/perl/misc/Artistic.html)