GREPHISTORY (1)
display file names from Usenet history file
SYNOPSIS
grephistory
[
-e
]
[
-f filename
]
[
-h
]
[
-i
]
[
-l
]
[
-n
]
[
-o
]
[
-q
]
[
-s
]
[
-T
]
[
-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 pathname or the token of the
article if the article is stored by storage api 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 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.
-o
If the ``-o'' flag is used, then the overview data for that article
will be displayed.
This flag is available, if
<DBZ_TAGGED_HASH in config.data>
is ``DONT'' and
extendeddbz
in inn.conf is turned on.
-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 overview data
for that article will be displayed.
This flag is available, if
<DBZ_TAGGED_HASH in config.data>
is ``DONT'' and
extendeddbz
in inn.conf is turned on.
-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.
R$
This is revision \\$3, dated \\$4.
$Id: grephistory.1,v 1.1.2.1 1999/06/12 08:22:31 kondou Exp $
SEE ALSO
|
|