getlist(1)



GETLIST(1)                                                          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,  distributions,  or  news-
       groups.     These   values   request   the   active(5),   active.times,
       <pathetc in inn.conf>/distributions.   or  <pathdb  in  inn.conf>/news-
       groups 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  start-
       ing with a character found in types are printed.

       For  example,  the  following command will obtain the one-line descrip-
       tions 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), inn.conf(5), nnrpd(8), wildmat(3).

                                                                    GETLIST(1)

Man(1) output converted with man2html
list of all man pages