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.