archive



ARCHIVE(8)                                                          ARCHIVE(8)




NAME

       archive - Usenet article archiver


SYNOPSIS

       archive [ -a archive ] [ -c ] [ -f ] [ -i index ] [ -p newsgroup-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 sequence 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,  archive  will   generate   a   copy   in
       <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 <patharchive in inn.conf>.

       -c     If the ‘‘-c’’ flag is used, then directory names will  be  flat-
              tened  as if by the ‘‘-f’’ flag; additionally, all posts will be
              concatenated into a single file , appending if the file  already
              exists,  with  the  final component of the filename being YYYYMM
              based on the local execution time of archive.  In this case,  on
              December    14,    1998,   the   file   would   be   copied   to
              <patharchive in inn.conf>/comp.sources.unix/199812.

       -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 as well as the Message-ID
              and Subject headers.

       -p newsgroup-list
              Limits the targets taken from the Xref:  header  to  the  groups
              specified in newsgroup-list.  The newsgroup-list is a comma-sep-
              arated uwildmat(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\
                   :<pathbin in inn.conf>/archive -f -i \
                       <patharchive in inn.conf>/INDEX



HISTORY

       Written by Rich $alz <rsalz@uunet.uu.net> for  InterNetNews.   This  is
       revision 1.10, dated 2002/12/03.


SEE ALSO

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



                                                                    ARCHIVE(8)

Man(1) output converted with man2html