GETLIST(1)

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,  distribu-
       tions, or newsgroups.  These values request the active(5),
       active.times,       /var/lib/news/distributions,        or
       /var/lib/news/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 lt;chongo@toad.com for Inter-
       NetNews.

SEE ALSO
       active(5) nnrpd(8) wildmat(3).