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 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.)
OPTIONS
-a archive
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, 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 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
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 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 temporary file to be the name of the input file,
and then exit.
EXAMPLES
A typical
newsfeeds(5)
entry to archive most source newsgroups 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 InterNetNews.
This is revision 1.7.2.1, dated 2000/08/17.
