archive - Usenet article archiver
archive [ -a archive ] [ -c ] [ -f ] [ -i index ] [ -p newsgroups list ] [ -r ] [ input ]
Archive makes copies of files specified on its standard input. It is normally run either
as a channel feed under innd(8), or by a script before expire(8) is run.
Archive reads the named input file, or standard input if no file is given. The input is
taken as a set of lines. Blank lines and lines starting with a number sign (``#'') are
ignored. All other lines should specify the token of an article to archive. Every arti-
cle is retrieved from a token and the Xref: header is used to determine the target file in
the archive directory. You can limit the targets taken from the Xref: header with the
Files are copied to a directory within the archive directory, <patharchive in inn.conf>.
The default is to create a hierarchy that mimics the input files; intermediate directories
will be created as needed. For example, if the input token represents article 2211 in the
newsgroup comp.sources.unix, it will be copied to
<patharchive in inn.conf>/comp/sources/unix/2211.)
If the ``-a'' flag is used then its argument specifies the directory to archive in
instead of the default.
-c If the ``-c'' flag is used, then all directory names will be flattened out, replac-
ing the slashes with periods; and all posts will be concatenated into a single file
with the final component name being YYYYMM which means the local execution time of
archive(8). In this case, on December 14, 1998, the file would be copied to
<patharchive in inn.conf>/comp.sources.unix/199812. Note: The ``-c'' flag implies
the ``-f'' flag.
-f If the ``-f'' flag is used, then all directory names will be flattened out, replac-
ing the slashes with periods. In this case, the file would be copied to
<patharchive in inn.conf>/comp.sources.unix/2211.
-i If the ``-i'' flag is used, then archive will append one line to the specified
index file for each article that it copies. This line will contain the destination
name and the Message-ID and Subject headers.
-p Limits the targets taken from the Xref: header to the groups specified in the news-
groups list. The newsgroups list is a comma separated wildmat(3) list of news-
groups you wish to have archive handle.
-r By default, archive sets its standard error to <pathlog in inn.conf>/errlog. To
suppress this redirection, use the ``-r'' flag.
If the input is exhausted, archive will exit with a zero status. If an I/O error occures,
it will try to spool its input, copying it to a file. If there was no input filename, the
standard input will be copied to <pathoutgoing in inn.conf>/archive and the program will
exit. If an input filename was given, a temporary file named input.bch (if input is an
absolute pathname) or <pathoutgoing in inn.conf>/input.bch (if the filename does not begin
with a slash) is created. Once the input is copied, archive will try to rename this tem-
porary file to be the name of the input file, and then exit.
A typical newsfeeds(5) entry to archive most source newsgroups is as follows:
:<PREFIX specified with --prefix at configure>/archive -f -i \
<patharchive in inn.conf>/INDEX
Written by Rich $alz <firstname.lastname@example.org> for InterNetNews. This is revision 126.96.36.199,