Marty O'Brien > Forks-Super-0.63 > Forks::Super::Queue

Download:
Forks-Super-0.63.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Stalled  1
View/Report Bugs
Module Version: 0.63   Source   Latest Release: Forks-Super-0.73

NAME ^

Forks::Super::Queue

VERSION ^

0.63

DESCRIPTION ^

Forks::Super::Queue is part of the Forks::Super distribution. The function and variables in this module manage the queue of "deferred processes" -- background tasks that have been specified but that can not or should not be run until some time in the future.

There should not be much reason for a Forks::Super user to call functions or manipulate variables in this module directly.

FUNCTIONS ^

Forks::Super::Queue::check_queue

Examines the queue of background tasks. Launches the tasks that are eligible to start.

This function is called automatically from your program during wait and waitpid calls, when the SIGCHLD handler runs, or during any "productive pause" (see "pause" in Forks::Super::Util) in your code.

VARIABLES ^

$Forks::Super::Queue::QUEUE_MONITOR_FREQ

When jobs are in the queue, a separate thread will signal the program and cause the queue to be examined every $QUEUE_MONITOR_FREQ seconds.

For programs with lots of quick jobs, this variable can be set to a small value to make sure the queue is examined frequently.

For programs with CPU-intensive, long running jobs, this variable can be set to a large value so that not too many processing resources are wasted examining the queue.

$Forks::Super::Queue::QUEUE_DEBUG

If set to a true value, the Forks::Super::Queue module will publish additional messages to the debugging output handle (see "$DEBUG_FH" in Forks::Super::Debug) about what the module is doing. These messages may or may not be interesting.

This variable will be set at run-time if the environment variable FORKS_SUPER_QUEUE_DEBUG is set.

AUTHOR ^

Marty O'Brien, <mob@cpan.org>

LICENSE AND COPYRIGHT ^

Copyright (c) 2009-2012, Marty O'Brien.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

See http://dev.perl.org/licenses/ for more information.

syntax highlighting: