[unix-history] / usr / contrib / nntp / doc / getactive.1

.TH GETACTIVE 1 "1 September 1985"
.UC 4
.SH NAME
getactive \- retrieve the active file from the remote news server
.SH SYNOPSIS
.B /usr/local/lib/rn/getactive filename
.SH DESCRIPTION
.I Getactive
retrieves the newsgroup ``active file'' (which contains
the list of all known newsgroups and their high/low message
numbers) from the news server on a remote machine and
places it in
.I filename.
.PP
The normal use is in support of shell scripts (such as
.I newsgroups
or
.IR newsetup )
which have been taken from existing software, such
as
.I rn.
When used, the file the active file is retrieved into is
usually something like
.IR /tmp/active.$$ ,
and should be deleted before the shell script exits.
.SH BUGS
The pathname shown in the synopsis is system-specific
and will depend on how you install
.I rn.
.SH AUTHOR
Phil Lapsley
Commit	Line	Data
a87c02c8 C	1	.TH GETACTIVE 1 "1 September 1985"
	2	.UC 4
	3	.SH NAME
	4	getactive \- retrieve the active file from the remote news server
	5	.SH SYNOPSIS
	6	.B /usr/local/lib/rn/getactive filename
	7	.SH DESCRIPTION
	8	.I Getactive
	9	retrieves the newsgroup ``active file'' (which contains
	10	the list of all known newsgroups and their high/low message
	11	numbers) from the news server on a remote machine and
	12	places it in
	13	.I filename.
	14	.PP
	15	The normal use is in support of shell scripts (such as
	16	.I newsgroups
	17	or
	18	.IR newsetup )
	19	which have been taken from existing software, such
	20	as
	21	.I rn.
	22	When used, the file the active file is retrieved into is
	23	usually something like
	24	.IR /tmp/active.$$ ,
	25	and should be deleted before the shell script exits.
	26	.SH BUGS
	27	The pathname shown in the synopsis is system-specific
	28	and will depend on how you install
	29	.I rn.
	30	.SH AUTHOR
	31	Phil Lapsley