afickonfig - a tool to manage Afick's config files

NAME

afickonfig - a tool to manage Afick's config files


DESCRIPTION

afickonfig is to change parameters in afick's config file, in a batch way. It can add, replace, remove any components (macro, alias, directives, rules) It was designed to work with same options names as afick (directives).

Note : in the current version, it can checks some arguments syntax before applying,

The idea came from the ``postconf'' utility from postfix.


SYNOPSIS

afickonfig.pl [options] [action] [macros] [alias] [directives] [rules]

afick use posix syntax, which allow many possibilities :


OPTIONS

options are used to control afickconfig

--config_file|-c configfile
read the configuration in config file named ``configfile''.
--check_config|-C
only check config file syntax and exit with the number of errors
--clean_config|-G
check config file syntax, clean bad line, and exit with the number of errors
--help|-?
Output summary help information and exit.
--man
Output full help information and exit.
--print_config
display internals variables after arguments and config file parsing (for debugging purposes)
--version|-V
Output version information and exit.
--verbose|-v
add debugging messages

ACTIONS

actions are used to change afick's configuration

--allow_overload,(--noallow_overload)
if set, allow rule overload (the last rule wins), else put a warning and keep the first rule.
--archive|-A directory
write reports to ``directory''.
--database|-D name
use the database named ``name''.
--debug|-d level
set a level of debugging messages, from 0 (none) to 3 (full)
--full_newdel|-f,(--nofull_newdel)
(do not) report full information on new and deleted directories.
--history|-y historyfile
write session status to history file
--ignore_case|-a
ignore case for file names. Can be helpful on Windows platforms, but is dangerous on Unix ones.
--missing_files|-m,(--nomissing_files)
(do not) warn about files declared in config files which does not exists.
--max_checksum_size|-S size
fix a maximum size (bytes) for checksum. on bigger files, compute checksum only on first 'size' bytes. (0 means no limit)
--dead_symlinks|-s,(--nodead_symlinks)
(do not) warn about dead symlinks.
--follow_symlinks,(--nofollow_symlinks)
if set, do checksum on target file, else do checksum on target file name.
--running_files|-r,(--norunning_files)
(do not) warn about ``running'' files : modified since program begin.
--timing|-t,(--notiming)
(do not) Print timing statistics.
--exclude_suffix|-x ``ext1 ext2 ... extn''
list of suffixes (files/directories ending in .ext1 or .ext2 ...) to ignore.
--exclude_prefix|-X ``pre1 pre2 ... pren''
list of prefix (files/directories beginning with pre1 or pre2 ...) to ignore.
--exclude_re|-R ``pat1 pat2 ... patn''
list of patterns (regular expressions) to ignore files or directories

MACROS

macros are to be set in afick configuration format (see afick.conf(5)) : '@@define macro value'


ALIAS

aliases are to be set in afick configuration format (see afick.conf(5)) : 'newrule = attributes'


DIRECTIVES

directives are to be set in afick configuration format (see afick.conf(5)) : 'directive := value'


RULES

rules are to be set in afick configuration format (see afick.conf(5)) : 'file alias'

you can also use

--addpath
add PATH directories to rules
--addlib
add libraries directories to rules (linux)

FILES

if no config file on command line, afick try to open /etc/afick.conf (Unix) or windows.conf (Windows) as default config

for config file syntax see afick.conf(5)


USE

afickonfig may

change a config
if it can find an old config
add a config
if it does not find a previous value
remove a config
you just have to specify a parameter without any value. the old line is commented

EXAMPLES

To use this program, you must just run it with same afick command line options :

afickonfig.pl -c afick.conf --timing --norunnig_files --debug=1 --archive=afick_archive

or the same in configuration file syntax :

afickonfig.pl -c afick.conf 'timing := 1' ' running_files := no' 'debug:=1 'archive:=afick_archive'

and a mix of all types

afickonfig.pl -c afick.conf --timing 'debug:=1' '@@define BATCH 0' 'newrule = p+u+g' '/tmp newrule'

remove lines

afickonfig -c afick.conf 'debug:=' '@@define BATCH' 'newrule=' '/tmp'


RETURN VALUES

The exit status is the number of real changes


NOTES

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

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


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

 afickonfig - a tool to manage Afick's config files