NAME¶

CFG2SCM - Check configuration changes into SCM

SYNOPSIS¶

cfg2scm.pl --all --check-consistency --storage=svn|cvs|tar|tar.gz|tar.bz2 --outfile=file --base-url=url --repository=name --username=username --password=password --message=commit message --help --version

DESCRIPTION¶

Check configuration changes into SCM (like SVN, CVS, ... or tar file)

OPTIONS¶

--storage=svn|cvs|tar|tar.gz|tar.bz2

type of storage, either "svn", "cvs", "tar", "tar.gz" or "tar.bz2"

--outfile=file

This option only works with storage-types tar, tar.gz, tar.bz2. The extension is set automatically, if not given.

--base-url=url

url

--repository=name

name

--username=username

username

--password=password

password

--message=commit message

commit message

--help

Prints a short summary of options.

--version

Prints the cfg2scm.pl version

--all

This is a short key for --check-consistency --find-unpacked

--check-consistency

This option checks the consistency of configurations-files as declared in the RPMs, by invoking rpm -Vca. It produces a file /var/lib/support/Configuration_Consistency.include, which is preserved between different cfg2scm.pl-runs. The list contains all names of configuration files, which are tagged as configuration files within the RPMs and were changed compared to the release shipped within the RPMs.

The following standard cfg2scm.pl-run includes the file /var/lib/support/Configuration_Consistency.include, as described below (section FILES) and commits the full content of the changed files.

Please note, that this really might need a long time (from 5-20 minutes).

--find-unpacked

Find files below /etc, that do not belong to any RPM, and for that reason should be documented. A file /var/lib/support/Find_Unpacked.include is written as "cache".

FILES file-lists in /var/lib/support/¶

From a tool called "PaDS" by Thorsten Wandersmann cfg2scm.pl inherited the ability, to extend the list of configuration files. To achieve that, just put a perl-snippet in the directory "/var/lib/support/"; this snippet must have the extension ".include" and may include only one perl-statement: an array-declaration for the array @files, that contains the file-names with full path, see EXAMPLES below.

See also --check-consistency and --find-unpacked above.

ERRORS¶

Enough:-|

DIAGNOSTICS¶

-

EXAMPLES¶

Check configuration files and commit everything.

"cfg2scm.pl --check-consistency"

A typical file to include the configurations files of the application "foobar" could look like this:

 # /var/lib/support/foobar.include
 
 @files= (
        "/etc/opt/foobar/foo.conf",
        "/etc/opt/foobar/bar.conf"
        );
 # eof

AUTHOR¶

The CFG2SCM project was created by Matthias G. Eckermann <mge@suse.de>; many thanks to Günther Deschner <gd@suse.de> and Manfred Hollstein <mh@novell.com> for tips and code.

LICENSE¶

Copyright (C) 2005-2006 SuSE Linux, a Novell Business

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.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.