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)