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