1ARCHIVE(8) System Manager's Manual ARCHIVE(8)
2
6 archive - Usenet article archiver
7
9 archive [ -a archive ] [ -c ] [ -f ] [ -i index ] [ -p newsgroup-list ]
10 [ -r ] [ input ]
11
13 Archive makes copies of files specified on its standard input. It is
14 normally run either as a channel feed under innd(8), or by a script
15 before expire(8) is run.
16 Archive reads the named input file, or standard input if no file is
18 given. The input is taken as a sequence of lines; blank lines and
19 lines starting with a number sign (``#'') are ignored. All other lines
20 should specify the token of an article to archive. Every article is
21 retrieved from a token, and the Xref: header is used to determine the
22 target file in the archive directory. You can limit the targets taken
23 from the Xref: header with the ``-p'' option.
24 Files are copied to a directory within the archive directory,
26 <patharchive in inn.conf>. The default is to create a hierarchy that
27 mimics the input files; intermediate directories will be created as
28 needed. For example, if the input token represents article 2211 in the
29 newsgroup comp.sources.unix, archive will generate a copy in
30 <patharchive in inn.conf>/comp/sources/unix/2211.
31
33 -a archive
34 If the ``-a'' flag is used then its argument specifies the
35 directory to archive in instead of <patharchive in inn.conf>.
36 -c If the ``-c'' flag is used, then directory names will be flat‐
38 tened as if by the ``-f'' flag; additionally, all posts will be
39 concatenated into a single file , appending if the file already
40 exists, with the final component of the filename being YYYYMM
41 based on the local execution time of archive. In this case, on
42 December 14, 1998, the file would be copied to
43 <patharchive in inn.conf>/comp.sources.unix/199812.
44 -f If the ``-f'' flag is used, then all directory names will be
46 flattened out, replacing the slashes with periods. In this
47 case, the file would be copied to
48 <patharchive in inn.conf>/comp.sources.unix/2211.
49 -i If the ``-i'' flag is used, then archive will append one line to
51 the specified index file for each article that it copies. This
52 line will contain the destination name as well as the Message-ID
53 and Subject headers.
54 -p newsgroup-list
56 Limits the targets taken from the Xref: header to the groups
57 specified in newsgroup-list. The newsgroup-list is a comma-sep‐
58 arated uwildmat(3) list of newsgroups you wish to have archive
59 handle.
60 -r By default, archive sets its standard error to
62 <pathlog in inn.conf>/errlog. To suppress this redirection, use
63 the ``-r'' flag.
64
66 If the input is exhausted, archive will exit with a zero status. If an
67 I/O error occures, it will try to spool its input, copying it to a
68 file. If there was no input filename, the standard input will be
69 copied to <pathoutgoing in inn.conf>/archive and the program will exit.
70 If an input filename was given, a temporary file named input.bch (if
71 input is an absolute pathname) or <pathoutgoing in inn.conf>/input.bch
72 (if the filename does not begin with a slash) is created. Once the
73 input is copied, archive will try to rename this temporary file to be
74 the name of the input file, and then exit.
75
78 A typical newsfeeds(5) entry to archive most source newsgroups is as
79 follows:
80 source-archive\
82 :!*,*sources*,!*wanted*,!*.d\
83 :Tc,Wn\
84 :<pathbin in inn.conf>/archive -f -i \
85 <patharchive in inn.conf>/INDEX
86
89 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is
90 revision 5909, dated 2002-12-03.
91
93 inn.conf(5), newsfeeds(5).
94 ARCHIVE(8)