NAME

     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,  distributions,
     or   newsgroups.    These   values  request  the  active(5),
     active.times,     /usr/local/news/etc/distributions,      or
     /usr/local/news/etc/newsgroups files, respectively.

OPTIONS

     -h   If the ``-h'' flag is used, then the  program  connects
          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  char-
     acter 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 avail-
     able on all servers.

HISTORY

     Written by Landon Curt Noll <chongo@toad.com> for  InterNet-
     News.

SEE ALSO

     active(5), nnrpd(8), wildmat(3).