GREPHISTORY(1)						      General Commands Manual						    GREPHISTORY(1)

NAME

       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 existense.

       -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 happen when an article  has	been  can-
	      celed,  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 displayed.  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 for each article that is still available.  This flag is used in processing ``sendme'' control messages.

       -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 InterNetNews.  This is revision 1.6.2.1, dated 2000/08/17.

SEE ALSO

       dbz(3), history(5), inn.conf(5).

																    GREPHISTORY(1)