NARC

NAME

SYNOPSIS

DESCRIPTION

If he newsgroup is moderated, a volume subdirectory and the file name within that directory are determined from the posting. Otherwise, a three-digit name is given to the file, with numbering being supplied by a file .names within the archive directory. This file is created by narc as required. It ensures unique naming for files being saved en bloc.

OPTIONS

-a archive-directory

The archive directory. This directory (which must already exist) is on the first level below the archive base, which is specified by the environment variable ARCHIVE. The specification for -a overrides the value of the environment variable ARCDIR.

-p

The prompt flag will cause the user to be prompted for an archive volume and for the name of each of the files into which the articles are to be saved.

-v archive-volume

The archive volume. This directory (which must already exist) is on the second level of the archive, below ARCDIR. It is useful for the management of moderated newsgroups. -v overrides the value of the environment variable ARCVOL.

-x

Debugging. Narc will tell you what its going to do, but then do it in the cwd instead.

ENVIRONMENT VARIABLES

ARCHIVE

Specifies the path for the directory in which the archives directories are maintained. ARCHIVE must be defined, or an equivalent definition made in assemble and narc.

FILES

~/.narcrc

Colon-separated fields that describe what to do for standard newsgroups. In the format:

          newsgroup:archive-directory[:volume-tag]

where the interpretation of the colon-separated fields is as follows.

The first name to be found on the "Newsgroups: " line in the article header. The directory associated with this newsgroup. The beginning of the line in the archive header that flags the line that specifies the volume in a moderated newsgroup. If this entry is empty, an un-moderated newsgroup is implied.

The .narcrc entry for comp.sources.unix is:

         comp.sources.unix:unix:Posting-number

This is because the header for postings to this newsgroup has the entries

         Newsgroups: comp.sources.unix

and
         Posting-number: Volume 16, Issue 1

The volume-tag field is needed because not all moderated newsgroups use the same header to identify the current volume for the archive. On the other hand, they all use the header

         Archive-name: <stuff>

to identify the name of the archive entry.

.names

Created in archive directory for un-moderated newsgroup to keep track of saved articles.

Indexr

Created in each archive directory to receive subject line (slightly modified) for each article saved in that directory. It's expected that the user will extract one line for each group of related articles, clean it up and place it in the Index file in that directory.

DIAGNOSTICS

<filename> exists! (a)ppend, (i)gnore or (r)eplace [r]?

You've already saved a file by this name. Its not a repost, because we handle that case.

Unable to rename %s

Failure from the rename system call.

Could not find newsgroup (or volume) within nnn lines

Narc must read ahead in the input stream to find the headers. Because input may be from a pipe, it must buffer in order to re-process what's already scanned. You've just exceeded the size of the buffer! Either this the Newsgroup header is missing or your favorite moderator has permitted an article to slip through without the volume-tag header.

Archive directory for %s?

The article you are processing is not one of those listed in your .narcrc file. You need to specify an archive directory.

Could not chdir to <directory>

Sorry, chdir failed.

Error opening %s

General-purpose error message, with interpreted system error to follow.

SEE ALSO

AUTHOR

Geoffrey Leach
{att,bellcore,sun,ames,pyramid}!pacbell!laticorp!geoff

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

ENVIRONMENT VARIABLES

FILES

DIAGNOSTICS

SEE ALSO

AUTHOR