NAME

Net::Peep::Scheduler - Perl extension for scheduling events for Peep, the Network Auralizer.

SYNOPSIS

  use Net::Peep::Scheduler;
  my $scheduler = new Net::Peep::Scheduler;

  $scheduler->schedulerAddEvent(
    'test_program', 6, 0, 'test_event', \&handler, $data);

  $scheduler->schedulerExplicitWakeUp();

DESCRIPTION

Net::Peep::Scheduler provides methods for scheduling events to run concurrently, using sigalarm. The scheduler makes use of Time::HiRes to allow scheduling of events up to microsecond accuracy. Scheduled events will always be played in order of soonest scheduled time, regardless of the order the events were fed to the scheduler.

Note that this module also defines its own debugging level - 8. That's one notch below 'Whoa Nelly', so use with extreme prejudice.

EXPORT

None by default.

CLASS ATTRIBUTES

  $VERSION - The CVS revision of this module.

PUBLIC METHODS

  new() - Net::Peep::Scheduler constructor.

  schedulerAddEvent($app_name, $future_secs, $future_usecs,
                    $type, $handler_coderef, $handler_data)
  Schedules an event for $future_secs seconds and
  $future_usecs microseconds in the future. When the event
  occurs, the $handler_coderef is executed and passed
  whatever data is referenced by $handler_data. The
  application should also identify itself via $app_name and
  register the type of event with $type.

  scheduleExplicitWakeUp() - Tells the scheduler explicitly
  to wake up and execute the closest scheduled event.

AUTHOR

Michael Gilfix <mgilfix@eecs.tufts.edu> Copyright (C) 2001

SEE ALSO

perl(1), peepd(1), Net::Peep::BC, Net::Peep::Client, Net::Peep::Log.

http://peep.sourceforge.net

CHANGE LOG

$Log: Scheduler.pm,v $ Revision 1.2 2001/08/08 20:17:57 starky Check in of code for the 0.4.3 client release. Includes modifications to allow for backwards-compatibility to Perl 5.00503 and a critical bug fix to the 0.4.2 version of Net::Peep::Conf.

Revision 1.1 2001/06/04 06:53:09 starky A scheduler for events requiring the sigalrm signal for handling. See the PODs for more detail.