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, /etc/news/distributions, or /var/lib/news/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 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 InterNetNews.

SEE ALSO

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

                                                                                                      GETLIST(1)