manpagez: man pages & more
man afickonfig(1)
Home | html | info | man
afickonfig(1)         User Contributed Perl Documentation        afickonfig(1)




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 :

       o   long (--) options

       o   short (-) options

       o   negative (--no) options


REQUIRED ARGUMENTS

       if run without arguments, afickonfig will just check the default config
       file


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
           select 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


USAGE

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

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

       or the same command in configuration file syntax :

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

       or a mix of all syntaxes

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

       to remove lines, give an empty value

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


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


DIAGNOSTICS

       all warnings go to stderr


EXIT STATUS

       The exit status is the number of real changes


CONFIGURATION

       no specific configuration file


DEPENDENCIES

       perl


INCOMPATIBILITIES

       (none)


BUGS AND LIMITATIONS

       (none known)


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



perl v5.10.0                      2009-07-24                     afickonfig(1)

afick 2.14-1 - Generated Sun Aug 9 09:15:57 CDT 2009
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.