GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PARANOID::LOG::BUFFER (3)

.ds Aq ’

NAME

Paranoid::Log::Buffer - Log Buffer Functions

CONTENTS

VERSION

$Id: Buffer.pm,v 0.83 2010/06/03 19:03:46 acorliss Exp $

SYNOPSIS



  use Paranoid::Log;
 
  enableFacility(events, buffer, debug, +);
  enableFacility(more-events, buffer, debug, +, 100);

  @messages = Paranoid::Log::Buffer::dump($name);



DESCRIPTION

This module implements named buffers to be used for logging purposes. Each buffer is of a concrete size (definable by the developer) with a max message length of 2KB. Each message is stored with a timestamp. Once the buffer hits the maximun number of entries it begins deleting the oldest messages as the new messages come in.

Buffers are created automatically on the fly, and messages trimmed before being stored.

With the exception of the <B>dumpB> function this module is not meant to be used directly. <B>Paranoid::LogB> should be your exclusive interface for logging.

When enabling a buffer facility with <B>Paranoid::LogB> you can add one integral argument to the call. That number defines the size of the log buffer in terms of number of entries allowed.

<B>NOTE:B> Buffers are maintained within process memory. If you fork a process from a parent with a log buffer each copy will maintain its own entries.

SUBROUTINES/METHODS

<B>NOTEB>: Given that this module is not intended to be used directly nothing is exported.

    init

    log

    remove

    Paranoid::Log::Buffer::dump



  @entries = Paranoid::Log::Buffer::dump($name);



This dumps all current entries in the named buffer. Each entry is an array reference to a two-element array. The first element is the timestamp of the message (in UNIX epoch seconds), the second the actual message itself.

DEPENDENCIES

o Paranoid::Debug

SEE ALSO

o Paranoid::Log

BUGS AND LIMITATIONS

AUTHOR

Arthur Corliss (corliss@digitalmages.com)

LICENSE AND COPYRIGHT

This software is licensed under the same terms as Perl, itself. Please see http://dev.perl.org/licenses/ for more information.

(c) 2005, Arthur Corliss (corliss@digitalmages.com)

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PARANOID::LOG::BUFFER (3) 2010-06-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.