Index Index for
Section 8
Index Alphabetical
listing for A
Bottom of page Bottom of
page		 

ARCHIVE(8)


NAME

  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 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.


SEE ALSO

  inn.conf(5), newsfeeds(5).

Index Index for
Section 8
Index Alphabetical
listing for A
Top of page Top of
page