4 archive \- Usenet article archiver
20 .BI \-p " newsgroup-list"
30 makes copies of files specified on its standard input.
31 It is normally run either as a channel feed under
40 file, or standard input if no file is given.
41 The input is taken as a sequence of lines;
42 blank lines and lines starting with a number sign (``#'') are ignored.
43 All other lines should specify the token of an article to archive.
44 Every article is retrieved from a token,
45 and the Xref: header is used to determine the target file in the
47 You can limit the targets taken from the Xref: header with the ``\-p'' option.
49 Files are copied to a directory within the archive directory,
50 .IR <patharchive\ in\ inn.conf> .
51 The default is to create a hierarchy that mimics the input files;
52 intermediate directories will be created as needed.
53 For example, if the input token represents article 2211 in the newsgroup
56 will generate a copy in
57 .IR <patharchive\ in\ inn.conf>/comp/sources/unix/2211 .
61 If the ``\-a'' flag is used then its argument specifies the directory to
63 .IR <patharchive\ in\ inn.conf> .
66 If the ``\-c'' flag is used, then directory names will be flattened as if
67 by the ``\-f'' flag; additionally, all posts will be concatenated into a
69 appending if the file already exists, with the final component of the
70 filename being YYYYMM based on the local execution time of
72 In this case, on December 14, 1998, the file would be copied to
73 .IR <patharchive\ in\ inn.conf>/comp.sources.unix/199812 .
76 If the ``\-f'' flag is used, then all directory names will be
77 flattened out, replacing the slashes with periods.
78 In this case, the file would be copied to
79 .IR <patharchive\ in\ inn.conf>/comp.sources.unix/2211 .
82 If the ``\-i'' flag is used, then
84 will append one line to the specified
86 file for each article that it copies.
87 This line will contain the destination name as well as the Message-ID and
91 Limits the targets taken from the Xref: header to the groups specified in
97 list of newsgroups you wish to have
104 sets its standard error to
105 .IR <pathlog\ in\ inn.conf>/errlog .
106 To suppress this redirection, use the ``\-r'' flag.
108 If the input is exhausted,
110 will exit with a zero status.
111 If an I/O error occures, it will try to spool its input, copying it to a file.
112 If there was no input filename, the standard input will be copied to
113 .I <pathoutgoing in inn.conf>/archive
114 and the program will exit.
115 If an input filename was given, a temporary file named
119 is an absolute pathname)
121 .I <pathoutgoing in inn.conf>/input.bch
122 (if the filename does not begin with a slash) is created.
123 Once the input is copied,
125 will try to rename this temporary file to be the name of the input file,
131 entry to archive most source newsgroups is as follows:
136 :!*,*sources*,!*wanted*,!*.d\e
138 :<pathbin in inn.conf>/archive \-f \-i \e
139 <patharchive in inn.conf>/INDEX
144 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
146 This is revision \\$3, dated \\$4.
148 .R$ $Id: archive.8 5909 2002-12-03 05:17:18Z vinocur $