Provided by: inn_1.7.2q-39_i386 bug

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)