The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
XAS-0.15
River stage one • 6 direct dependents • 6 total dependents
1 ++
/ xas-rotate

NAME

xas-rotate - rotate files based on a configuration file

SYNOPSIS

xas-rotate [--help] [--debug] [--manual] [--version]

 options:
   --help     outputs simple help text
   --manual   outputs the procedures manual
   --version  outputs the apps version
   --debug    toogles debugging output
   --alerts   toogles alert notifications

DESCRIPTION

This procedure is a simple template to help write standardized procedures.

OPTIONS AND ARGUMENTS

-logfile

The name of the log file to use. Defaults to stderr.

-cfgfile

The configuration file to use. The configuration file has the following format:

 [settings]
 compressor = zip         - default file compressor
 zip-command              - zip command defaults to 'c:\bin\zip.exe'
 gzip-command             - gzip command defaults to 'c:\bin\gzip.exe'
 bzip2-command            - bzip2 command defaults to 'c:\bin\bzip2.exe'
 compress-command         - compress command defaults to 'c:\bin\compress.exe'
 tail-command             - tail command defaults to 'c:\bin\tail.exe'

 [log\test.log]           - file to process, may have DOS wildcards
 compress = true          - wither to compress the file
 method = move            - how to handle the file
 missingok = false        - whither a missing file is OK
 lines-or-files = files   - 
 create-new = false       - create a new file after rotation
 modify-age               - process based on last modification
 create-age               - process based in creation time
 file-size                - process based on file size
 ifempty                  - process if file is empty
 file-count               - number of rotated files kept
 line-count               - how many line to transfer to new file
 prolog                   - command to process before rotation
 epilog                   - command to process after rotation
 pause                    - number of seconds to pause after prolog and epilog
--help

Displays a simple help message.

--debug

Turns on debbuging.

--alerts

Togggles alert notification.

--manual

The complete documentation.

--version

Prints out the apps version

EXIT CODES

 0 - success
 1 - failure

SEE ALSO

XAS::Apps::Rotate

AUTHOR

Kevin L. Esteb, <kevin@kesteb.us>

COPYRIGHT AND LICENSE

Copyright (C) 2014 by Kevin L. Esteb

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.