/ 
Forks-Queue-0.15
River stage zero No dependents
/ Forks::Queue::Shmem

NAME

Forks::Queue::Shmem - Forks::Queue implementation using shared memory

SYNOPSIS

use Forks::Queue::Shmem;
$q = Forks::Queue::Shmem->new;

use Forks::Queue;
$q = Forks::Queue->new( impl => 'Shmem, ... );

VERSION

0.15

DESCRIPTION

Shared memory implementation of Forks::Queue. Only available on systems that have a /dev/shm virtual filesystem.

A shared memory implementation is appropriate for programs that rapidly update the queue but are not likely to let the size of data in the queue exceed the available memory on the host machine. Use Forks::Queue::File if you demand high capacity for your queue.

See Forks::Queue for the public API to this class.

Constructor options

In addition to the standard options described in the Forks::Queue constructor, the Forks::Queue::Shmem constructor also recognizes some additional options:

  • file

    The name of the filename to hold the queue data. An absolute pathname should not be provided here. The virtual queue file will reside under the shared memory virtual filesystem (probably /dev/shm) on your system, if it exists.

  • style

  • limit

  • on_limit

  • join

  • persist

    See "new" in Forks::Queue for descriptions of these options.

  • debug

    Boolean value to enable or disable debugging on this queue, overriding the value in $Forks::Queue::DEBUG.

LICENSE AND COPYRIGHT

Copyright (c) 2017-2019, 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.10.1 or, at your option, any later version of Perl 5 you may have available.

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