NAME

App::Sysadmin::Log::Simple::File - a file-logger for App::Sysadmin::Log::Simple

VERSION

version 0.005

DESCRIPTION

This provides methods to App::Sysadmin::Log::Simple for logging to a file, and viewing those log files.

METHODS

new

This creates a new App::Sysadmin::Log::Simple::File object. It takes a hash of options with keys:

logdir

This specifies the top of the tree of log files. Default is /var/log/sysadmin. Please note that unprivileged users are typically not permitted to create the default log directory.

index_preamble

This is a string to place at the top of the index page.

view_preamble

This is a string to prepend when viewing the log files.

date

This is a DateTime object for when the log entry was made or for specifying which date's log file to view, depending on the mode of operation.

view

This allows users to view a log file in a pager provided by IO::Pager, typically less(1).

log

This creates a new log file if needed, adds the log entry to it, and re-generates the index file as necessary.

AVAILABILITY

The project homepage is http://p3rl.org/App::Sysadmin::Log::Simple.

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see https://metacpan.org/module/App::Sysadmin::Log::Simple/.

SOURCE

The development version is on github at http://github.com/doherty/App-Sysadmin-Log-Simple and may be cloned from git://github.com/doherty/App-Sysadmin-Log-Simple.git

BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the web interface at https://github.com/doherty/App-Sysadmin-Log-Simple/issues.

AUTHOR

Mike Doherty <doherty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Mike Doherty.

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