1 package IPC::MorseSignals;
8 IPC::MorseSignals - Communicate between processes with Morse signals.
16 our $VERSION = '0.17';
20 Due to the POSIX signals specification (which I wasn't aware of at the time I wrote this module), this module is by nature completely unreliable and will never work properly.
21 It is therefore B<deprecated>.
22 Please don't use it (if you were actually crazy enough to use it).
26 # In the sender process
27 use IPC::MorseSignals::Emitter;
29 my $deuce = IPC::MorseSignals::Emitter->new(speed => 1024);
30 $deuce->post('HLAGH') for 1 .. 3;
35 # In the receiver process
36 use IPC::MorseSignals::Receiver;
39 my $pants = IPC::MorseSignals::Receiver->new(\%SIG, done => sub {
40 print STDERR "GOT $_[1]\n";
45 This module implements a rare form of IPC by sending Morse-like signals through C<SIGUSR1> and C<SIGUSR2>.
46 Both of those signals are used, so you won't be able to keep them for something else when you use this module.
52 L<IPC::MorseSignals::Emitter> is a base class for emitters ;
56 L<IPC::MorseSignals::Receiver> is a base class for receivers.
60 But, seriously, use something else for your IPC. :)
64 When the same signal is sent several times in a row to a process, the POSIX standard does not guarantee that the relevant signal handler will be called for each of the notifications.
65 This will result in malformed messages if the transfer speed is so high that the operating system does not have the time to call the signal handler for each bit.
69 You need the complete L<Bit::MorseSignals> distribution.
71 L<Carp> (standard since perl 5), L<POSIX> (idem) and L<Time::HiRes> (since perl 5.7.3) are also required.
75 L<IPC::MorseSignals::Emitter>, L<IPC::MorseSignals::Receiver>.
77 L<Bit::MorseSignals>, L<Bit::MorseSignals::Emitter>, L<Bit::MorseSignals::Receiver>.
79 L<perlipc> for information about signals in perl.
81 For truly useful IPC, search for shared memory, pipes and semaphores.
85 Vincent Pit, C<< <perl at profvince.com> >>, L<http://www.profvince.com>.
87 You can contact me by mail or on C<irc.perl.org> (vincent).
91 Please report any bugs or feature requests to C<bug-ipc-morsesignals at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IPC-MorseSignals>.
92 I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
96 You can find documentation for this module with the perldoc command.
98 perldoc IPC::MorseSignals
100 =head1 ACKNOWLEDGEMENTS
102 Thanks for the inspiration, mofino ! I hope this module will fill all your IPC needs. :)
104 =head1 COPYRIGHT & LICENSE
106 Copyright 2007,2008,2013,2017 Vincent Pit, all rights reserved.
108 This program is free software; you can redistribute it and/or modify it
109 under the same terms as Perl itself.
113 1; # End of IPC::MorseSignals