ARCHIVE(8)

NAME
       archive - Usenet article archiver

SYNOPSIS
       archive [ -a archive ] [ -f ] [ -i index ] [ -m ] [ -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 name of a
       file to archive.  If a filename is not an  absolute  path-
       name, it is taken to be relative to /var/spool/news.

       Files  are copied to a directory within the archive direc-
       tory, /var/spool/news/news.archive.   The  default  is  to
       create a hierarchy that mimics the input files; intermedi-
       ate directories will be created as needed.   For  example,
       the input file comp/sources/unix/2211 (article 2211 in the
       newsgroup   comp.sources.unix)   will   be    copied    to
       /var/spool/news/news.archive/comp/sources/unix/2211.

OPTIONS
       -a archive
              If the ``-a'' flag is used then its argument speci-
              fies the directory to archive  in  instead  of  the
              default.

       -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
              /var/spool/news/news.archive/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.

       -m     Files are copied by making a link.  If that fails a
              new  file  is created.  If the ``-m'' flag is used,
              then the file will be copied  to  the  destination,
              and the input file will be replaced with a symbolic
              link pointing to the new file.

       -r     By default, archive  sets  its  standard  error  to
              /var/log/news/errlog.   To  suppress  this redirec-
              tion, 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
       /var/spool/news/out.going/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
       /var/spool/news/out.going/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\
                   :/usr/lib/news/bin/archive -f -i \
                       /usr/spool/news/news.archive/INDEX

HISTORY
       Written  by  Rich  $alz lt;rsalz@uunet.uu.net for InterNet-
       News.  This is revision 1.14, dated 1996/10/29.

SEE ALSO
       newsfeeds(5).