newsgroups(1) [bsd man page]

NEWSGROUPS(1)						      General Commands Manual						     NEWSGROUPS(1)

NAME

       newsgroups - a program to list unsubscribed newsgroups.

SYNOPSIS

       newsgroups pattern flag

DESCRIPTION

       The newsgroups program compares your .newsrc file with the file of active newsgroups, and prints a list of unsubscribed newsgroups matching
       pattern.  If the second argument "flag" is present, only newsgroups not found in your .newsrc are listed, and the display is not paged.	If
       the  second  argument  is  missing,  the  display  is paged, and an additional list of unsubscribed newsgroups occurring in your .newsrc is
       printed.

ENVIRONMENT

       DOTDIR  Where to find your .newsrc, if not in your home directory.

	       Default: $HOME

       HOME    Your home directory.

	       Default: $LOGDIR

       LOGDIR  Your home directory if HOME is undefined.

FILES

       /usr/lib/news/active or a reasonable facsimile
       ${DOTDIR-{$HOME-$LOGDIR}}/.newsrc

SEE ALSO

       rn(1), newsrc(5)

DIAGNOSTICS

BUGS

       The flag argument is a kludge.

								       LOCAL							     NEWSGROUPS(1)

GETLIST(1)						      General Commands Manual							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	newsgroups.   These  values  request  the active(5), active.times,
       <pathetc in inn.conf>/distributions.  or <pathdb in inn.conf>/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), inn.conf(5), nnrpd(8), wildmat(3).

																	GETLIST(1)