1GETLIST(1) General Commands Manual GETLIST(1)
2
6 getlist - get a list from an NNTP server
7
9 getlist [ -A ] [ -h host ] [ list [ pattern [ types ] ] ]
10
12 The getlist program obtains a list from an NNTP server and sends it to
13 standard output.
14 The list may be one of active, active.times, distributions, or news‐
16 groups. These values request the active, active.times,
17 <pathetc in inn.conf>/distributions. or <pathdb in inn.conf>/news‐
18 groups files, respectively.
19
21 -A If the ``-A'' flag is used, then the program tries to authenti‐
22 cate as per passwd.nntp before issuing LIST command.
23 -h If the ``-h'' flag is used, then the program connects to the
25 server on the specified host. The default is to connect to the
26 server specified in the inn.conf file.
27 If the list parameter is active, then the pattern and types parameters
29 may be used to limit the output. When pattern is used, only active
30 lines with groups that match according to uwildmat(3) are printed.
31 When types is also given, only active lines that have a fourth field
32 starting with a character found in types are printed.
33 For example, the following command will obtain the one-line descrip‐
35 tions of all newsgroups found on UUNET:
36 getlist -h news.uu.net newsgroups
37 The following line lists all groups where local postings are permitted,
39 are moderated or aliased:
40 getlist active '*' ym=
41 Note that the listing files other than the active file is a common
43 extension to the NNTP protocol and may not be available on all servers.
44
46 Written by Landon Curt Noll <chongo@toad.com> for InterNetNews.
47
49 active(5), active.times(5), inn.conf(5), nnrpd(8), uwildmat(3).
50 GETLIST(1)