1GREPHISTORY(1)            InterNetNews Documentation            GREPHISTORY(1)
2
3
4

NAME

6       grephistory - Query the INN history database
7

SYNOPSIS

9       grephistory [-eilnqsv] [-f db] [message-id]
10

DESCRIPTION

12       grephistory queries the INN history database for information about the
13       specified message ID.  If no flags are given, the program prints the
14       storage API token of the corresponding article, or "/dev/null" if the
15       article is listed in the history database but not stored on the server.
16       If the message ID cannot be found in the database, grephistory will
17       print "grephistory: not found" and exit with a non-zero status.
18
19       Be sure to escape any special characters in the message ID from the
20       shell.  Single quotes are recommended for this purpose since many mes‐
21       sage IDs contain dollar signs.
22

OPTIONS

24       -e  Only print the storage token if the article is stored on the sys‐
25           tem.  (In other words, suppress the "/dev/null" or "not found" out‐
26           put for missing or remembered articles.)
27
28       -f db
29           Query the history database db rather than the default history data‐
30           base.
31
32       -i  Rather than expecting a message ID on the command line, grephistory
33           will read a list of message IDs on standard input, one per line.
34           Leading and trailing whitespace is ignored, as are any malformed
35           lines.  It will print out standard output those message IDs which
36           are not found in the history database.  This is used when process‐
37           ing "ihave" control messages.
38
39       -l  Display the entire line from the history database, rather than just
40           the storage API token.
41
42       -n  If the message ID is present in the history database but has no
43           storage API token, print "/dev/null" and exit successfully.  This
44           can happen if an article has been cancelled or expired, but history
45           information has still been retained.  This is the default behavior.
46
47       -q  Don't print any message, but still exit with the appropriate sta‐
48           tus.
49
50       -s  Rather than expecting a message ID on the command line, grephistory
51           will read a list of message IDs on standard input, one per line.
52           Leading and trailing whitespace is ignored, as are any malformed
53           lines.  It will print on standard output the storage API tokens for
54           any articles that are still available, one per line.  This flag is
55           used when processing "sendme" control messages.
56
57       -v  Print out the hash of the message ID for diagnostic purposes, as
58           well as any other requested information.  This flag is not useful
59           with -s.
60

HISTORY

62       Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  Rewritten
63       in POD by Russ Allbery <rra@stanford.edu>.
64
65       $Id: grephistory.1 7045 2004-12-19 19:37:45Z rra $
66

SEE ALSO

68       history(5), inn.conf(5)
69
70
71
72INN 2.4.2                         2004-12-19                    GREPHISTORY(1)
Impressum