ARCHIVE(8)ARCHIVE(8)NAMEarchive - Usenet article archiver
SYNOPSISarchive [ -aarchive ] [ -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-aarchive
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 con
tain 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 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 ALSOinn.conf(5), newsfeeds(5).
ARCHIVE(8)
