archive - Usenet article archiver
SYNOPSIS
archive [ -a archive ] [ -c ] [ -f ] [ -i index ] [ -p
newsgroups list ] [ -r ] [ input ]
DESCRIPTION
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 article 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 ``-p'' option.
Files are copied to a directory within the archive direc
tory, <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.)
OPTIONS
-a archive
If the ``-a'' flag is used then its argument speci
fies the directory to archive in instead of the
default.
-c If the ``-c'' flag is used, then all directory
names will be flattened out, replacing 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, replacing 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
Subject headers.
-p Limits the targets taken from the Xref: header to
the groups specified in the newsgroups list. The
newsgroups list is a comma separated wildmat(3)
list of newsgroups 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.
EXIT STATUS
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 file
name, 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 temporary file to be the name of the
input file, and then exit.
EXAMPLES
A typical newsfeeds(5) entry to archive most source news
groups is as follows:
source-archive\
:!*,*sources*,!*wanted*,!*.d\
:Tc,Wn\
:<PREFIX specified with --prefix at configure>/archive -f -i \
<patharchive in inn.conf>/INDEX
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNet
News. This is revision 1.7.2.1, dated 2000/08/17.
SEE ALSO
inn.conf(5), newsfeeds(5).
Man(1) output converted with
man2html