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 direc­
       tory, <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 speci­
              fies 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

              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 file­
       name, 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 news­
       groups 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  InterNet­
       News.  This is revision 1.7.2.1, dated 2000/08/17.


SEE ALSO

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


Man(1) output converted with man2html