Index for Section 1

Alphabetical listing for G

Bottom of page

GREPHISTORY(1)
NAME
  grephistory - display file names from Usenet history file

SYNOPSIS
  grephistory [ -e ] [ -f filename ] [ -i ] [ -l ] [ -n ] [ -q ] [ -s ] [ -v
  ] [ messageid ]

DESCRIPTION
  Grephistory queries the dbz(3) index into the history file for an article
  having a specified 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.

  Be sure to escape any special characters in the Message-ID from the shell.
  Single quotes are recommended for this purpose.

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.

  -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 canceled, or
       if it has been expired but its history is still retained.  This is the
       default behavior.

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

  -v   Each use of the ``-v'' flag increases the verbosity of grephistory.
       The default level is ``0'', and at present, the maximum useful level
       is ``1''.  At level 1, the hash of the Message-ID is printed out for
       diagnostic purposes.  This flag is not useful with ``-s''.

HISTORY
  Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is
  revision 1.10, dated 2002/12/03.

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

Index for Section 1

Alphabetical listing for G

Top of page