man-pages/man1/ucfq.1.html
2021-03-31 01:06:50 +01:00

133 lines
4.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of UCFQ</TITLE>
</HEAD><BODY>
<H1>UCFQ</H1>
Section: User Contributed Perl Documentation (1)<BR>Updated: 2006-04-16<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
ucfq - query the ucf database
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<PRE>
usage: ucfq [options] (/path/to/file|package)[/path/to/file|package ...]
</PRE>
<A NAME="lbAD">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>--help</B> <B>h</B> Print out a usage message.<DD>
<DT id="2"><B>--debug</B> <B>-d</B> Turn on debugging mode.<DD>
<DT id="3"><B>--verbose</B> <B>-v</B> Make the script more verbose..<DD>
<DT id="4"><B>--with-colons</B> <B>-w</B><DD>
<DL COMPACT><DT id="5"><DD>
<DL COMPACT><DT id="6"><DD>
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.
</DL>
</DL>
<DL COMPACT><DT id="7"><DD>
</DL>
<DT id="8"><B>--state-dr</B> dir<DD>
<DL COMPACT><DT id="9"><DD>
<DL COMPACT><DT id="10"><DD>
Set the state directory to <TT>&quot;/path/to/dir&quot;</TT> instead of the default
<TT>&quot;/var/lib/ucf&quot;</TT>. Used mostly for testing.
</DL>
</DL>
<DL COMPACT><DT id="11"><DD>
</DL>
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIPTION</H2>
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.
<P>
This script can potentially be used in package <TT>&quot;postrm&quot;</TT> 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 <B>ucf</B> using <TT>&quot;ucfr&quot;</TT>.
<A NAME="lbAF">&nbsp;</A>
<H2>CAVEATS</H2>
This is very inchoate, at the moment, and needs testing.
<A NAME="lbAG">&nbsp;</A>
<H2>BUGS</H2>
None Known so far.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
Manoj Srivastava &lt;srivasta\@debian.org&gt;
<A NAME="lbAI">&nbsp;</A>
<H2>COPYRIGHT AND LICENSE</H2>
This script is a part of the Ucf package, and is
<P>
Copyright (c) 2006 Manoj Srivastava &lt;srivasta\@debian.org&gt;
<P>
This program is free software; you can redistribute it and / or modify
it under the terms of the <FONT SIZE="-1">GNU</FONT> General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
<P>
This program is distributed in the hope that it will be useful,
but <FONT SIZE="-1">WITHOUT</FONT> <FONT SIZE="-1">ANY</FONT> <FONT SIZE="-1">WARRANTY</FONT>; without even the implied warranty of
<FONT SIZE="-1">MERCHANTABILITY</FONT> or <FONT SIZE="-1">FITNESS</FONT> <FONT SIZE="-1">FOR</FONT> A <FONT SIZE="-1">PARTICULAR</FONT> <FONT SIZE="-1">PURPOSE</FONT>. See the
<FONT SIZE="-1">GNU</FONT> General Public License for more details.
<P>
You should have received a copy of the <FONT SIZE="-1">GNU</FONT> General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, <FONT SIZE="-1">MA</FONT> 02111-1307 <FONT SIZE="-1">USA</FONT>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
<DT id="13"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="14"><A HREF="#lbAD">OPTIONS</A><DD>
<DT id="15"><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT id="16"><A HREF="#lbAF">CAVEATS</A><DD>
<DT id="17"><A HREF="#lbAG">BUGS</A><DD>
<DT id="18"><A HREF="#lbAH">AUTHOR</A><DD>
<DT id="19"><A HREF="#lbAI">COPYRIGHT AND LICENSE</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:28 GMT, March 31, 2021
</BODY>
</HTML>