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  -  LOG::DISPATCH::FILE::STAMPED (3)

.ds Aq ’

NAME

Log::Dispatch::File::Stamped - Logging to date/time stamped files

CONTENTS

VERSION

version 0.12

SYNOPSIS



  use Log::Dispatch::File::Stamped;

  my $file = Log::Dispatch::File::Stamped->new(
    name      => file1,
    min_level => info,
    filename  => Somefile.log,
    stamp_fmt => %Y%m%d,
    mode      => append );

  $file->log( level => emerg, message => "Ive fallen and I cant get up\n" );



DESCRIPTION

This module subclasses Log::Dispatch::File for logging to date/time stamped files, respecting all its configuration options.

METHODS

new(%p) This method takes the same set of parameters as Log::Dispatch::File::new(), with the following differences:
-- filename ($) The filename template. The actual timestamp will be appended to this filename when creating the actual logfile. If the filename has an extension, the timestamp is inserted before the extension. See examples below.
-- stamp_fmt ($) The format of the timestamp string. This module uses POSIX::strftime to create the timestamp string from the current local date and time. Refer to your platform’s strftime documentation for the list of allowed tokens.

Defaults to ’%Y%m%d’.

log_message( message => $ ) Sends a message to the appropriate output. Generally this shouldn’t be called directly but should be called through the log() method (in Log::Dispatch::Output).

EXAMPLES

Assuming the current date and time is:



  % perl -e print scalar localtime
  Sat Feb  8 13:56:13 2003

  Log::Dispatch::File::Stamped->new(
    name      => file,
    min_level => debug,
    filename  => logfile.txt,
  );



This will log to file ’logfile-20030208.txt’.



  Log::Dispatch::File::Stamped->new(
    name      => file,
    min_level => debug,
    filename  => logfile.txt,
    stamp_fmt => %d%H,
  );



This will log to file ’logfile-0813.txt’.

SEE ALSO

Log::Dispatch::File, POSIX.

ACKNOWLEDGEMENTS

Dave Rolsky, author of the Log::Dispatch suite and many other fine modules on CPAN.

This module was rewritten to respect all present (and future) options to Log::Dispatch::File by Karen Etheridge, <ether@cpan.org>.

AUTHORS

o Eric Cholet <cholet@logilune.com>
o Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Karen Etheridge.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

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


perl v5.20.3 LOG::DISPATCH::FILE::STAMPED (3) 2013-06-17

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