prunehistory



PRUNEHISTORY(8)                                                PRUNEHISTORY(8)




NAME

       prunehistory - remove tokens from Usenet history file


SYNOPSIS

       prunehistory [ -f filename ] [ -p ]


DESCRIPTION

       Prunehistory modifies a history(5)-format text file to ‘‘remove’’ a set
       of tokens from it.  The tokens are removed  by  overwriting  them  with
       spaces, so that the size and position of any following entries does not
       change.  This has an effect similar to expiring the article, in that it
       is still mentioned in the history database but cannot be retrieved.

       Prunehistory  reads the standard input.  The input is taken as a set of
       lines.  Blank lines and lines starting with a number sign  (‘‘#’’)  are
       ignored.   All  other lines are should consist of a Message-ID followed
       by zero or more other fields (which are ignored).

       The Message-ID is used as the dbz(3) key to get an offset into the text
       file.

       Since innd(8) only appends to the text file, prunehistory does not need
       to have any interaction with it.


OPTIONS

       -p     Prunehistory will normally complain about lines that do not fol-
              low  the  correct  format.  If the ‘‘-p’’ flag is used, then the
              program will silently print any invalid lines  on  its  standard
              output.    (Blank  lines  and  comment  lines  are  also  passed
              through.)  This can be useful when prunehistory  is  used  as  a
              filter for other programs such as reap.

       -f filename
              The     default     name     of     the    history    file    is
              <pathdb in inn.conf>/history; to specify a different  name,  use
              the ‘‘-f’’ flag.


HISTORY

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


SEE ALSO

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



                                                               PRUNEHISTORY(8)

Man(1) output converted with man2html