grephistory - display file names from Usenet history file
SYNOPSIS
grephistory [ -e ] [ -f filename ] [ -h ] [ -i ] [ -l ] [
-n ] [ -q ] [ -s ] [ -t ] [ messageid ]
DESCRIPTION
Grephistory queries the dbz(3) index into the history(5)
file for an article having a specified Message-ID or hash
key of Message-ID.
If messageid cannot be found in the database, the program
prints ``Not found'' and exits with a non-zero status. If
messageid is in the database, the program prints the token
of the article and exits successfully.
OPTIONS
-e If the ``-e'' flag is used, then grephistory will
only print the filename of the token of an existing
article.
-f To specify a different value for the history file
and database, use the ``-f'' flag.
-h If the ``-h'' flag is used then the hash of the
Message-ID will be printed regardless of its exis
tense.
-i If the ``-i'' flag is used, then grephistory will
read a list of Message-ID's on standard input, one
per line. Leading and trailing whitespace is
ignored, as are any malformed lines. It will print
on standard output those Message-ID's which are not
found in the history database. This flag is used
in processing ``ihave'' control messages.
-l If the ``-l'' flag is used then the entire line
from the history file will be displayed.
-n If no pathname exists, the program will print
``/dev/null'' and exit successfully. This can hap
pen when an article has been canceled, or if it has
been expired but its history is still retained.
This is default behavior, which can be obtained by
using the ``-n'' flag.
-q If the ``-q'' flag is used, then no message is dis
played. The program will still exit with the
appropriate exit status.
-s If the ``-s'' flag is used, then grephistory will
read a similar list from its standard input. It
will print on standard output a list of filenames
flag is used in processing ``sendme'' control mes
sages.
-t If the ``-t'' flag is used, then only the offset
into the history text file is printed.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNet
News. This is revision 1.6.2.1, dated 2000/08/17.
SEE ALSO
dbz(3), history(5), inn.conf(5).
Man(1) output converted with
man2html