getlist - get a list from an NNTP server
SYNOPSIS
getlist [ -h host ] [ list [ pattern [ types ] ] ]
DESCRIPTION
The getlist program obtains a list from an NNTP server and
sends it to standard output.
The list may be one of active, active.times, distribu
tions, or newsgroups. These values request the active(5),
active.times, <pathetc in inn.conf>/distributions. or
<pathdb in inn.conf>/newsgroups files, respectively.
OPTIONS
-h If the ``-h'' flag is used, then the program con
nects to the server on the specified host. The
default is to connect to the server specified in
the inn.conf(5) file.
If the list parameter is active, then the pattern and
types parameters may be used to limit the output. When
pattern is used, only active lines with groups that match
according to wildmat(3) are printed. When types is also
given, only active lines that have a fourth field starting
with a character found in types are printed.
For example, the following command will obtain the one-
line descriptions of all newsgroups found on UUNET:
getlist -h news.uu.net newsgroups
The following line lists all groups where local postings
are permitted, are moderated or aliased:
getlist active '*' ym=
Note that the listing files other than the active file is
a common extension to the NNTP protocol and may not be
available on all servers.
HISTORY
Written by Landon Curt Noll <chongo@toad.com> for Inter
NetNews.
SEE ALSO
active(5), inn.conf(5), nnrpd(8), wildmat(3).
Man(1) output converted with
man2html