


ARCHIVE(8)                                             ARCHIVE(8)


NNAAMMEE
       archive - Usenet article archiver

SSYYNNOOPPSSIISS
       aarrcchhiivvee [ --aa _a_r_c_h_i_v_e ] [ --ff ] [ --ii _i_n_d_e_x ] [ --mm ] [ --rr ] [
       _i_n_p_u_t ]

DDEESSCCRRIIPPTTIIOONN
       _A_r_c_h_i_v_e makes copies of files specified  on  its  standard
       input.   It is normally run either as a channel feed under
       _i_n_n_d(8), or by a script before _e_x_p_i_r_e(8) is run.

       _A_r_c_h_i_v_e reads the named _i_n_p_u_t 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 _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s.

       Files  are copied to a directory within the archive direc-
       tory, _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s_/_n_e_w_s_._a_r_c_h_i_v_e.   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 _c_o_m_p_/_s_o_u_r_c_e_s_/_u_n_i_x_/_2_2_1_1 (article 2211 in the
       newsgroup   comp.sources.unix)   will   be    copied    to
       _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s_/_n_e_w_s_._a_r_c_h_i_v_e_/_c_o_m_p_/_s_o_u_r_c_e_s_/_u_n_i_x_/_2_2_1_1.    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
       _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s_/_n_e_w_s_._a_r_c_h_i_v_e_/_c_o_m_p_._s_o_u_r_c_e_s_._u_n_i_x_/_2_2_1_1.

       If  the  ``-i'' flag is used, then _a_r_c_h_i_v_e will append one
       line to the specified _i_n_d_e_x file for each article that  it
       copies.   This  line will contain the destination name and
       the Message-ID and Subject headers.

       For example, a typical _n_e_w_s_f_e_e_d_s(5) entry to archive  most
       source newsgroups is as follows:
              source-archive\
                   :!*,*sources*,!*wanted*,!*.d\
                   :Tc,Wn\
                   :/usr/lib/news/bin/archive -f -i \
                       /usr/spool/news/news.archive/INDEX

       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.

       By   default,   _a_r_c_h_i_v_e   sets   its   standard  error  to
       _/_u_s_r_/_l_i_b_/_n_e_w_s_/_e_r_r_l_o_g.  To suppress this  redirection,  use
       the ``-r'' flag.




                                                                1





ARCHIVE(8)                                             ARCHIVE(8)


       If  the  input is exhausted, _a_r_c_h_i_v_e 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
       _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s_/_o_u_t_._g_o_i_n_g_/_a_r_c_h_i_v_e  and  the  program  will
       exit.  If an input filename was given,  a  temporary  file
       named  _i_n_p_u_t.bch  (if  _i_n_p_u_t  is  an absolute pathname) or
       _/_u_s_r_/_s_p_o_o_l_/_n_e_w_s_/_o_u_t_._g_o_i_n_g_/input.bch (if the filename  does
       not  begin  with  a  slash) is created.  Once the input is
       copied, _a_r_c_h_i_v_e will try to rename this temporary file  to
       be the name of the input file, and then exit.

HHIISSTTOORRYY
       Written  by  Rich  $alz <rsalz@uunet.uu.net> for InterNet-
       News.  This is revision 1.8, dated 1992/08/19.

SSEEEE AALLSSOO
       newsfeeds(5).







































                                                                2


