| Name : perl-Logfile-Rotate
| |
| Version : 1.04
| Vendor : obs://build_opensuse_org/devel:languages:perl
|
| Release : lp155.6.1
| Date : 2023-07-20 18:24:00
|
| Group : Development/Libraries/Perl
| Source RPM : perl-Logfile-Rotate-1.04-lp155.6.1.src.rpm
|
| Size : 0.04 MB
| |
| Packager : https://www_suse_com/
| |
| Summary : Perl module to rotate logfiles.
|
Description :
I have used the name space of the Logfile::Base manpage package by _Ulrich
Pfeifer_, as the use of this module closely relates to the processing
logfiles.
* new
\'new\' accepts the following arguments, \'File\', \'Count\', \'Gzip\', \'Pre\',
\'Post\', \'Flock\' and \'Dir\' with only \'File\' being mandatory. \'new\' will
open and lock the file, so you may co-ordinate the processing of the file
with rotating it. The file is closed and unlocked when the object is
destroyed, so you can do this explicitly by \'undef\'\'ing the object.
The \'Pre\'/\'Post\' arguments allow you to pass function references to this
method, which you may use as a callback for any processing you want
before or after the rotation. For example, you may notify the process
writing to the file that it has been rotated.
The \'Pre\' function is passed the current filename to be rotated as an
argument and the \'Post\' function is passed the current filename that was
rotated and that file\'s new filename including any extension added by
compression previously.
Both the \'Pre\' and \'Post\' function references you provide are executed
within an \'eval\' statement inside the \'rotate\' method. If the \'eval\'
returns an error then the \'rotate\' method will croak at that point.
The \'Signal\' argument is deprecated by the \'Post\' argument.
The \'Flock\' argument allows you to specify whether the perl function
\'flock\' is used to lock the file during the rotation operation.
Apparently flock causes problems on some platforms and this option has
been added to allow you to control the programs behaviour. By default the
file will be locked using \'flock\'.
The \'Persist\' argument allows you to control whether the program will try
and set the current log file ownership and permissions on any new files
that may be created by the rotation. In some circumstances the program
doing the file rotation may not have sufficient permission to \'chown\' on
the file. By default the program will try and preserve ownership and
permissions.
* rotate()
This method will copy the file passed in \'new\' to a file of the same
name, with a numeric extension and truncate the original file to zero
length. The numeric extension will range from 1 up to the value specified
by Count, or 7 if none is defined, with 1 being the most recent file.
When Count is reached, the older file is discarded in a FIFO (first in,
first out) fashion. If the argument \'Dir\' was given, all old files will
be placed in the specified directory.
The \'Post\' function is the last step executed by the rotate method so the
return code of rotate will be the return code of the function you proved,
or 1 by default.
The copy function is implemented by using the the File::Copy manpage
package, but I have had a few people suggest that they would prefer the
File::Move manpage. I\'m still not decided on this as you would loose data
if the move should fail.
|
RPM found in directory: /packages/linux-pbone/ftp5.gwdg.de/pub/opensuse/repositories/devel:/languages:/perl:/CPAN-L/15.5/noarch |
