1GETLIST(1)                InterNetNews Documentation                GETLIST(1)
2
3
4

NAME

6       getlist - Get a list from an NNTP server
7

SYNOPSIS

9       getlist [-AR] [-h host] [-p port] [list [pattern [types]]]
10

DESCRIPTION

12       getlist obtains a list from an NNTP server and sends it to standard
13       output.  list may be one of "active" (which is the default value),
14       "active.times", "distrib.pats", or "newsgroups".  "active" contains a
15       list of all newsgroups carried by the server with the high and low
16       article numbers in the group, and the group status field.
17       "active.times" is a list of newsgroups, their creation times (in
18       seconds since epoch), and the creator of the group.  "distrib.pats" is
19       a list of relevant distributions and the newsgroups they apply to.
20       "newsgroups" is a list of newsgroups along with their short
21       descriptions.
22
23       For more information on the formats of these files, see active(5),
24       active.times(5), distrib.pats(5) and newsgroups(5).
25
26       The listing files other than the active file are common extensions to
27       the NNTP protocol and may not be available on all servers.  For
28       instance, "counts" "distributions", "headers", "moderators", "motd",
29       "overview.fmt" and "subscriptions", amongst other, may be available.
30       Moreover, a uwildmat pattern pattern may also be usable for some of
31       these listing files.
32
33       For more information on the formats of these files, see
34       distributions(5), moderators(5), motd.news(5) and subscriptions(5).
35       The overview fields obtained with "overview.fmt" are the ones for which
36       the overview database is consistent (see extraoverviewadvertised in
37       inn.conf for more information).  The list obtained with "headers"
38       contains the fields that can be retrieved using the HDR command
39       (pattern can then be either "msgid" or "range").  The list obtained
40       with "counts" is like the "active" one except that the number of
41       articles in a newsgroup is mentioned just before the flag of this
42       newsgroup.
43
44       The pattern parameter may be used with a list value of "active",
45       "active.times" or "newsgroups" to limit the output.  If given, only
46       entries corresponding to newsgroups that match the uwildmat pattern
47       pattern will be printed.
48
49       If the list parameter is "active", a third parameter, types, may also
50       be used to restrict the list.  If given, only entries corresponding to
51       newsgroups with a newsgroup mode found in types will be printed.  For
52       example, a types value of "y" would only show unmoderated groups, and a
53       types value of "ym" would show all unmoderated and moderated groups but
54       not aliased groups or groups that disallow postings.
55

OPTIONS

57       -A  Try to authenticate using the username and password information in
58           passwd.nntp(5) before issuing the LIST command.
59
60       -h host
61           Connect to the server host rather than to the value of server in
62           inn.conf or the value of the NNTPSERVER environment variable.
63
64       -p port
65           Connect to the port port, which is by default 119.
66
67       -R  Try to switch to nnrpd with a MODE READER command before issuing
68           the LIST request.  It can be useful in case a feeding access exists
69           for the news server: more information can be retrieved from nnrpd,
70           compared with innd.
71

EXAMPLES

73       The following command will obtain the one-line descriptions of all
74       newsgroups found on UUNET:
75
76           getlist -h news.uu.net newsgroups
77
78       The following command will show the active file entries for all
79       moderated comp.* groups on the default server:
80
81           getlist active 'comp.*' m
82
83       The following command lists all groups where local postings are
84       permitted, are moderated or aliased:
85
86           getlist active '*' ym=
87
88       Note that the wildcard character "*" has to be quoted by simple quotes
89       to protect it from the shell.
90

HISTORY

92       Written by Landon Curt Noll <chongo@toad.com> for InterNetNews.
93       Rewritten in POD by Russ Allbery <eagle@eyrie.org>.
94

SEE ALSO

96       active(5), active.times(5), distrib.pats(5), distributions(5),
97       inn.conf(5), libinn_uwildmat(3), moderators(5), motd.news(5),
98       newsgroups(5), nnrpd(8), passwd.nntp(5), subscriptions(5).
99
100
101
102INN 2.7.0                         2022-07-10                        GETLIST(1)
Impressum