redhat man page for archive

ARCHIVE(8)						      System Manager's Manual							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  news-
       group 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 sepa-
	      rated 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).

																	ARCHIVE(8)