README
1NAME
2 Net::Wake - A package to send packets to power on computers.
3
4SYNOPSIS
5 To send a wake-on-lan packet via UDP:
6 Net::Wake::by_udp('255.255.255.255', '00:00:87:A0:8A:D2');
7
8 Or directly from the command line:
9 perl -MNet::Wake -e "Net::Wake::by_udp(undef,'00:00:87:A0:8A:D2')"
10
11DESCRIPTION
12 This package sends wake-on-lan (AKA magic) packets to turn on machines
13 that are wake-on-lan capable.
14
15 For now there is only one function in this package:
16 Net::Wake::by_udp([$host], $mac_address, [$port]);
17
18 You can omit the colons in the $mac_address, but not leading zeros.
19
20 Generally speaking, you should use a broadcast address for $host. Using
21 the host's last known IP address is usually not sufficient since the IP
22 address may no longer be in the ARP cache. A $host value of
23 '255.255.255.255' is implied if $host is undef. If you wish to send a
24 magic packet to a remote subnet, you can use a variation of
25 '192.168.0.255', given that you know the subnet mask to generate the
26 proper broadcast address.
27
28SEE ALSO
29 http://gsd.di.uminho.pt/jpo/software/wakeonlan/mini-howto/
30
31COPYRIGHT
32 Copyright 1999-2003 Clinton Wong
33
34 This program is free software; you can redistribute it and/or modify it
35 under the same terms as Perl itself.
36
37