RKIVE

Section: User Commands (1)
Index Return to Main Contents
 

NAME

rkive - archive USENET source groups  

SYNOPSIS

rkive [ -dstuvV ] [ -n newsgroup ]  

DESCRIPTION

rkive is used to archive the USENET sources groups to an alternate location as specified in an rkive configuration file. Archives can be maintained in one of three ways:

Archive-Name - The moderators of most sources groups assign an official Archive-Name to each article that gets submitted to the net. In this manner, each file has a "new-login" or "elm/part06" type of format. For multi-part postings, a subdirectory is created (as indicated in the elm example) to hold the separate "parts". This format is used by many large archive sites because it is easier for retrieval via mail request software such as netlib and the filenames give hints as to what the software is.

Volume-Issue - Software sent via most moderated groups have an assigned Volume and Issue number. This allows the moderators to track and reference the individual items that have been posted to the group. Each individual article is given an "Issue" number. The Issues are grouped together into a "Volume". There are roughly 100 articles in each Volume but this is an arbitrary split totally up to the moderator. This format is extremely useful when the software archives are cataloged. It makes searching of the files quicker and verification of complete volumes easier. This archive format is recommended for any site that will be doing massive searches of the individual volumes since it keeps the quadratic nature of directory searches from making your life miserable.

Article Number - The news software stores the articles locally by naming the news article by a number generated on every site. The Article Number ordering is unique to each site. If an Article Number archive is requested (or required by the newsgroup), the news article file is copied to the directory specified in the archive configuration file. The name of the archived article will match the original name generated by the news software.

By means of a configuration file (see rkive(5)), the archive administrator is able to control how archiving is performed. The administrator can specify on a per newsgroup basis:

        o The type of the archiving, such as Volume-Issue
          Archive-Name, or Article Number archiving,
        o Where the newsgroup archive is to be stored on disk,
        o The location of log file for the newsgroup,
        o The format of the logfile records,
        o The location of index file for the newsgroup,
        o The format of the index file records,
        o A list of users to be sent mail when an article is archived,
        o The owner/group and modes of each archived member, and
        o Whether the archived members should be compressed or not.

This program is normally started from cron on a daily basis. Archiving
of newly arrived software is only done once for each file. If rkive 
is started daily, the posted sources are placed into the sources archive 
the first day the software arrives on the machine instead of having to 
wait for expire -a to run.

 

OPTIONS

-d
Turn on debugging output. This is more "verbose" than the verbose option below. (-v assumed)
-f config_file
This option allows the user to specify the file to be used as the rkive configuration file.
-g
This option allows the global default values to be displayed in the newsgroup variables when there is nothing specified in the newsgroup entry of the configuration file. Only applicable with debugging and if a verbose status is requested.
-n newsgroup
This restricts the execution to just the newsgroup indicated. The newsgroup needs to be specified in a "comp.sources.unix" format. Only one newsgroup can be processed in this manner. If this option is not specified, then all newsgroups specified in the rkive configuration file are processed.
-s
Print a quick status of the sources that currently reside within the USENET newsgroup directories for newsgroups specified in the rkive configuration file. The status displays whether an article has been archived or if it is still waiting to be archived. If it has been archived, the archived location is displayed.
-t
Test only, no archiving is done. Print a report of all actions that would take place if it was called without the test flag. (-v assumed)
-u
Unconditionally archive the articles. Normally the software will not overwrite an archive member if a file exists with the same name as the destination archived article. The use of this option ignores the check and overwrites an existing archive member.
-v
Verbose. Prints a file by file account of the actions.
-V
Print the version number and patchlevel of the current executable.

 

FILES

/usr/local/lib/rkive.cf  

SEE ALSO

article(1), rkive.cf(5), ckconfig(1)  

BUGS

None known.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO
BUGS

This document was created by man2html, using the manual pages.
Time: 06:38:03 GMT, December 12, 2024