Devel::RingBuffer 0.31

Devel::RingBuffer is a Perl module with shared memory ring buffers for Perl scripts diagnosis/debug.

SYNOPSIS

#
# create ringbuffer
#
use Devel::RingBuffer;
use Devel::RingBuffer::TieInt;

my $ringbuf = Devel::RingBuffer->new(
File => somefile.trace,
Rings => 20,
Slots => 20,
SlotSize => 300,
MessageSize => 256,
GlobalSize => 24 * 1024,
StopOnCreate => 0,
TraceOnCreate => 1) || die "Cant create a ring buffer.";

my $ring = $ringbuf->allocate();

Provides shared memory structures (using memory mapped files via IPC::Mmap) to be used by diagnostic and debugger applications for Perl scripts (see Devel::STrace). Using XS/C code to maximize performance, creates a set of ringbuffers with a configurable number of slots.

Each slot includes a field for a linenumber, a timestamp, and a fully qualified subroutine name. Each ring buffer also includes additional headers and fields to support diagnostic interfaces, e.g., watched expressions, command/reponse interfaces to the monitored applications, etc.