/ 
IPC-MorseSignals-0.17
River stage zero No dependents
/ IPC::MorseSignals::Emitter

NAME

IPC::MorseSignals::Emitter - Base class for IPC::MorseSignals emitters.

VERSION

Version 0.17

WARNING

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. It is therefore deprecated. Please don't use it (if you were actually crazy enough to use it).

SYNOPSIS

use IPC::MorseSignals::Emitter;

my $deuce = IPC::MorseSignals::Emitter->new(speed => 1024);
$deuce->post('HLAGH') for 1 .. 3;
$deuce->send($pid);

DESCRIPTION

This module sends messages processed by an underlying Bit::MorseSignal emitter to another process as a sequence of SIGUSR1 (for bits 0) and SIGUSR2 (for 1) signals.

METHODS

new

my $ime = IPC::MorseSignals::Emitter->new(
 delay => $seconds,
 speed => $bauds,
 %bme_options,
);

Creates a new emitter object. delay specifies the delay between two sends, in seconds, while speed is the number of bits sent per second. The delay value has priority over the speed, and defaults to 1 second. Extra arguments are passed to "new" in Bit::MorseSignals::Emitter.

send

$ime->send($pid);

Sends messages enqueued with "post" in Bit::MorseSignals::Emitter to the process $pid (or to all the @$pid if $pid is an array reference, in which case duplicated targets are stripped off).

delay

my $delay = $ime->delay;
$ime->delay($seconds);

Returns the current delay in seconds, or set it if an argument is provided.

speed

my $speed = $ime->speed;
$ime->speed($bauds);

Returns the current speed in bauds, or set it if an argument is provided.

IPC::MorseSignals::Emitter objects also inherit methods from Bit::MorseSignals::Emitter.

EXPORT

An object module shouldn't export any function, and so does this one.

DEPENDENCIES

Bit::MorseSignals::Emitter.

Carp (standard since perl 5), POSIX (idem) and Time::HiRes (since perl 5.7.3) are required.

SEE ALSO

IPC::MorseSignals, IPC::MorseSignals::Receiver.

Bit::MorseSignals, Bit::MorseSignals::Emitter, Bit::MorseSignals::Receiver.

perlipc for information about signals in perl.

For truly useful IPC, search for shared memory, pipes and semaphores.

AUTHOR

Vincent Pit, <perl at profvince.com>, http://www.profvince.com.

You can contact me by mail or on irc.perl.org (vincent).

BUGS

Please report any bugs or feature requests to bug-ipc-morsesignals-emitter at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IPC-MorseSignals. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc IPC::MorseSignals::Emitter

COPYRIGHT & LICENSE

Copyright 2007,2008,2013,2017 Vincent Pit, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.