SUBSCRIPTIONS(5) InterNetNews Documentation SUBSCRIPTIONS(5)NAME
subscriptions - Default recommended subscriptions
DESCRIPTION
The pathetc/subscriptions file contains a list of newsgroups that is returned by the NNTP command LIST SUBSCRIPTIONS.
Clients that support this command usually send it the first time they connect to a new news server. They use the returned list to
initialize the list of subscribed newsgroups. The subscriptions file therefore should contain groups intended for new users, for testing,
or that contain FAQs and other useful information for first-time Usenet users.
The syntax of the subscriptions file is trivial; it is a simple list of newsgroup names, one per line. The order of newsgroups may be
significant; the news reading client may present the groups in that order to the user.
EXAMPLE
A typical subscriptions file may look like:
news.announce.newusers
news.newusers.questions
local.test
local.general
local.talk
misc.test
misc.test.moderated
news.answers
news.announce.newgroups
This gives the client the FAQs and question newsgroup for new users first, then a local newsgroup for testing and various commonly-read
local discussion groups, followed by the world-wide test groups, all the FAQs, and announcements of new world-wide newsgroups. If there is
a local new users group, one might want to list it first.
HISTORY
Written by Bettina Fink <laura@hydrophil.de> for InterNetNews.
$Id: subscriptions.pod 8822 2009-11-20 17:34:15Z iulius $
SEE ALSO nnrpd(8).
INN 2.5.2 2010-02-08 SUBSCRIPTIONS(5)
Check Out this Related Man Page
GETLIST(1) InterNetNews Documentation GETLIST(1)NAME
getlist - Get a list from an NNTP server
SYNOPSIS
getlist [-AR] [-h host] [-p port] [list [pattern [types]]]
DESCRIPTION
getlist obtains a list from an NNTP server and sends it to standard output. list may be one of "active" (which is the default value),
"active.times", "distrib.pats", or "newsgroups". "active" contains a list of all newsgroups carried by the server with the high and low
article numbers in the group, and the group status field. "active.times" is a list of newsgroups, their creation times (in seconds since
epoch), and the creator of the group. "distrib.pats" is a list of relevant distributions and the newsgroups they apply to. "newsgroups"
is a list of newsgroups along with their short descriptions.
For more information on the formats of these files, see active(5), active.times(5), distrib.pats(5) and newsgroups(5).
The listing files other than the active file are common extensions to the NNTP protocol and may not be available on all servers. For
instance, "counts" "distributions", "headers", "moderators", "motd", "overview.fmt" and "subscriptions", amongst other, may be available.
Moreover, a uwildmat(3) pattern pattern may also be usable for some of these listing files.
For more information on the formats of these files, see distributions(5), moderators(5), motd.news(5) and subscriptions(5). The overview
fields obtained with "overview.fmt" are the ones for which the overview database is consistent (see extraoverviewadvertised in inn.conf for
more information). The list obtained with "headers" contains the fields that can be retrieved using the HDR command (pattern can then be
either "msgid" or "range"). The list obtained with "counts" is like the "active" one except that the number of articles in a newsgroup is
mentioned just before the flag of this newsgroup.
The pattern parameter may be used with a list value of "active", "active.times" or "newsgroups" to limit the output. If given, only
entries corresponding to newsgroups that match the uwildmat(3) pattern pattern will be printed.
If the list parameter is "active", a third parameter, types, may also be used to restrict the list. If given, only entries corresponding
to newsgroups with a newsgroup mode found in types will be printed. For example, a types value of "y" would only show unmoderated groups,
and a types value of "ym" would show all unmoderated and moderated groups but not aliased groups or groups that disallow postings.
OPTIONS -A Try to authenticate using the username and password information in passwd.nntp(5) before issuing the LIST command.
-h host
Connect to the server host rather than to the value of server in inn.conf or the value of the NNTPSERVER environment variable.
-p port
Connect to the port port, which is by default 119.
-R Try to switch to nnrpd with a MODE READER command before issuing the LIST request. It can be useful in case a feeding access exists
for the news server: more information can be retrieved from nnrpd, compared with innd.
EXAMPLES
The following command will obtain the one-line descriptions of all newsgroups found on UUNET:
getlist -h news.uu.net newsgroups
The following command will show the active file entries for all moderated comp.* groups on the default server:
getlist active 'comp.*' m
The following command lists all groups where local postings are permitted, are moderated or aliased:
getlist active '*' ym=
Note that the wildcard character "*" has to be quoted by simple quotes to protect it from the shell.
HISTORY
Written by Landon Curt Noll <chongo@toad.com> for InterNetNews. Rewritten in POD by Russ Allbery <rra@stanford.edu>.
$Id: getlist.pod 8837 2009-12-03 21:08:59Z iulius $
SEE ALSO active(5), active.times(5), distrib.pats(5), distributions(5), inn.conf(5), moderators(5), motd.news(5), newsgroups(5), nnrpd(8),
passwd.nntp(5), subscriptions(5), uwildmat(3).
INN 2.5.2 2010-02-08 GETLIST(1)