]> git.vpit.fr Git - perl/modules/IPC-MorseSignals.git/blob - README
Importing IPC-MorseSignals-0.13.tar.gz
[perl/modules/IPC-MorseSignals.git] / README
1 NAME
2     IPC::MorseSignals - Communicate between processes with Morse signals.
3
4 VERSION
5     Version 0.13
6
7 SYNOPSIS
8         # In the sender process
9         use IPC::MorseSignals::Emitter;
10
11         my $deuce = new IPC::MorseSignals::Emitter speed => 1024;
12         $deuce->post('HLAGH') for 1 .. 3;
13         $deuce->send($pid);
14
15         ...
16
17         # In the receiver process
18         use IPC::MorseSignals::Receiver;
19
20         local %SIG;
21         my $pants = new IPC::MorseSignals::Receiver \%SIG, done => sub {
22          print STDERR "GOT $_[1]\n";
23         };
24
25 DESCRIPTION
26     This module implements a rare form of IPC by sending Morse-like signals
27     through "SIGUSR1" and "SIGUSR2". Both of those signals are used, so you
28     won't be able to keep them for something else when you use this module.
29
30     IPC::MorseSignals::Emitter is a base class for emitters ;
31     IPC::MorseSignals::Receiver is a base class for receivers.
32
33     But, seriously, use something else for your IPC. :)
34
35 DEPENDENCIES
36     You need the complete Bit::MorseSignals distribution.
37
38     Carp (standard since perl 5), POSIX (idem) and Time::HiRes (since perl
39     5.7.3) are also required.
40
41 SEE ALSO
42     IPC::MorseSignals::Emitter, IPC::MorseSignals::Receiver.
43
44     Bit::MorseSignals, Bit::MorseSignals::Emitter,
45     Bit::MorseSignals::Receiver.
46
47     perlipc for information about signals in perl.
48
49     For truly useful IPC, search for shared memory, pipes and semaphores.
50
51 AUTHOR
52     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
53
54     You can contact me by mail or on #perl @ FreeNode (vincent or
55     Prof_Vince).
56
57 BUGS
58     Please report any bugs or feature requests to "bug-ipc-morsesignals at
59     rt.cpan.org", or through the web interface at
60     <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IPC-MorseSignals>. I
61     will be notified, and then you'll automatically be notified of progress
62     on your bug as I make changes.
63
64 SUPPORT
65     You can find documentation for this module with the perldoc command.
66
67         perldoc IPC::MorseSignals
68
69 ACKNOWLEDGEMENTS
70     Thanks for the inspiration, mofino ! I hope this module will fill all
71     your IPC needs. :)
72
73 COPYRIGHT & LICENSE
74     Copyright 2007-2008 Vincent Pit, all rights reserved.
75
76     This program is free software; you can redistribute it and/or modify it
77     under the same terms as Perl itself.
78