SYNOPSIS

 usage: ucfq [options] (/path/to/file|package)[/path/to/file|package  ...]

OPTIONS

--help h Print out a usage message.
--debug -d Turn on debugging mode.
--verbose -v Make the script more verbose..
--with-colons -w

Normally, the script presents the information in a human readable tabular format, but that may be harder for a machine to parse. With this option, the output is a compact, colon separated line, with no dividers, headers, or footer.

--state-dr dir

Set the state directory to \*(C`/path/to/dir\*(C' instead of the default \*(C`/var/lib/ucf\*(C'. Used mostly for testing.

DESCRIPTION

This script takes a set of arguments, each of which is a package name (and thus does not contain a /) or a full path to a configuration file, and outputs the associated package, if any, if the file exists on disk, and whether it has been modified by the user. The output is either a human readable tabular form, or a compact colon-separated machine friendly format.

This script can potentially be used in package \*(C`postrm\*(C' scripts during purge to query the system for configuration files that may still exist on the system, and whether these files have been locally modified by the user \*(-- assuming that the package registered all the configuration files with ucf using \*(C`ucfr\*(C'.

CAVEATS

This is very inchoate, at the moment, and needs testing.

BUGS

None Known so far.

AUTHOR

Manoj Srivastava <srivasta\@debian.org>

COPYRIGHT AND LICENSE

This script is a part of the Ucf package, and is

Copyright (c) 2006 Manoj Srivastava <srivasta\@debian.org>

This program is free software; you can redistribute it and / or modify it under the terms of the \s-1GNU\s0 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 \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the \s-1GNU\s0 General Public License for more details.

You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, \s-1MA\s0 02111-1307 \s-1USA\s0