\$1

'br}

'br}

{\

## NAME

ucfq - query the ucf database

## SYNOPSIS

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

## OPTIONS

\fB--help\fR \fBh\fR Print out a usage message. 3

\fB--debug\fR \fB-d\fR Turn on debugging mode. 3

\fB--verbose\fR \fB-v\fR Make the script more verbose.. 3

\fB--with-colons\fR \fB-w\fR 3

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.

\fB--state-dr\fR dir 3

Set the state directory to f(CW*(C`/path/to/dir*(C' instead of the default f(CW*(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 f(CW*(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 f(CW*(C`ucfr*(C'.

## CAVEATS

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

## BUGS

None Known so far.

## AUTHOR

Manoj Srivastava <srivastae@debian.org>

## COPYRIGHT AND LICENSE

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

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

This program is free software; you can redistribute it and / or modify it under the terms of the s-1GNUs0 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-1WITHOUTs0 s-1ANYs0 s-1WARRANTYs0; without even the implied warranty of s-1MERCHANTABILITYs0 or s-1FITNESSs0 s-1FORs0 A s-1PARTICULARs0 s-1PURPOSEs0. See the s-1GNUs0 General Public License for more details.

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