manpage of afick_archive

NAME

afick_archive - a tool to manage history file and archive directory

DESCRIPTION

afick_archive is designed to manage afick's archives reports. It allow to suppress old reports, check reports consistency, and search for informations in reports.

SYNOPSIS

afick_archive.pl [options] [actions]

REQUIRED ARGUMENTS

one of the 3 actions is mandatory (check, keep, search) (see below)

OPTIONS

options are used to control afick_archive

--config_file|-c configfile

read the configuration in config file named "configfile".

--help|-h

Output summary help information and exit.

--man

Output full help infomation and exit

--version|-V

Output version information and exit.

--verbose|-v

add debugging messages

--dry-run|-n

on cleaning actions (keep, clean_history), just simulate, do not remove anything

ACTIONS

--check|-C

check consistency in archives : check if a report is missing

--search|-s regex

regex is a regular expression to search in all reports, for exemple : "changed file :.*\.pl$" (search all changed perl files)

--keep|-k age

with age in the form xP, x un number, P can be d for days, w for weeks, m for months (ex : 2w ask for 2 weeks)

the software will remove all reports older than the specified period from archive directory.

--clean_history|-H

clean history file : remove line matching removed reports

USAGE

the archive directory may grow fast, if your config file is not adapted. afick_archive is to be run to avoid file system full.

EXAMPLES

Check archive consistency

afick_archive.pl --check

Remove reports older than 2 months

afick_archive.pl --keep 2m

Search all changed perl files

afick_archive.pl --search "changed file :.*\.pl$"

DEPENDENCIES

this program only use perl and its standard modules.

SEE ALSO

afick.conf(5) for the configuration file syntax


afick-tk(1) for the graphical interface


afick(1) for the command-line interface


afickonfig(1) for a tool to change afick's configuration file


afick_archive(1) for a tool to manage archive's reports


afick_learn(1) for a learning tool

DIAGNOSTICS

you can use the verbose option to provide diagnostics

EXIT STATUS

0 (not meaningful)

CONFIGURATION

this program uses the afick's configuration file

INCOMPATIBILITIES

none known

BUGS AND LIMITATIONS

no idea : you have to send me what you find

LICENSE AND COPYRIGHT

Copyright (c) 2002 Eric Gerbier All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

AUTHOR

Eric Gerbier

you can report any bug or suggest to gerbier@users.sourceforge.net

 manpage of afick_archive