xenial (1) nglister.1.gz

Provided by: nglister_1.0.1+nmu2_all bug

NAME

       NGLister - Tool to download newsgroup information from news servers

SYNOPSIS

       nglister [ -u username ] [ -p password ] [ -P port ] hostname filename

       nglister -h | --help

DESCRIPTION

       NGLister  is  a  tool  to  download  information  about groups and other information available on an NNTP
       (Usenet news) server.  It is designed to be fast and simple; just specify the server and the  information
       you want, and NGLister will send it to standard output.

       You can write the information to a file by appending:

       > filename

       to the end of your command-line.

INSTALLATION

       To  install  NGLister,  you will need a current version of Python <URL:http://www.python.org/>.  NGLister
       requires only one other piece of software: Optik.  You can find it at
        <URL:http://prdownloads.sourceforge.net/optik/Optik-1.3.tar.gz>.

       To install, run this command as root: python setup.py install

OPTIONS

       -u username
              Specifies the user name to use for logging into the server.  Use this only if your server requires
              authentication.

       -p password
              Specifies  the password to use for logging into the server.  Use this only if your server requires
              a password.

       -P port
              Specifies the numeric port to use when connecting.  Most servers listen on port 119,  the  default
              NNTP port, so that value is used by the default.  This option will only be needed rarely.

       hostname
              Specifies the name of the NNTP server.

       filename
              Specifies  the  name  of  the  data to retrieve from the remote NNTP server.  Most people will use
              active or newsgroups here.  The set of files supported varies from one server to the next.  Please
              note that this parameter does not denote an output filename or even a real filename; just the type
              of information you want from the server.  Here is a list of commonly-supported information  types.
              Additional  items are specified in RFC2980 <URL:http://www.ietf.org/rfc/rfc2980.txt> with the LIST
              command.

              • active lists all newsgroups and describes their numbering.

              • newsgroups lists the newsgroup descriptions.  Note that most servers do not  carry  descriptions
                for all groups, and the groups that lack a description will not be listed here at all.

              • active.times describes how recently each newsgroup has seen activity.

              • motd shows the server's "Message Of The Day" -- that is, current news about the server.

       -h

       --help Displays brief usage help.

CONFORMING TO

       • Network News Transport Protocol as specified in RFC 977

       • Common NNTP Extensions as specified in RFC 2980

       • Standard Python 2.2.1 as implemented on POSIX-compliant systems.

       NGLister and this manual, are Copyright (C) 2003 John Goerzen.

       This  program  is  free  software;  you  can  redistribute it and/or modify it under the terms of the GNU
       General Public License as published by the Free Software Foundation; either version 2 of the License,  or
       (at your option) any later version.

       This  program  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public
       License for more details.

       You  should have received a copy of the GNU General Public License along with this program; if not, write
       to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA

AUTHOR

       NGLister  its  libraries,  documentation,  and  all  included  files,  was  written   by   John   Goerzen
       <jgoerzen@complete.org> and copyright is held as stated in the COPYRIGHT section.

       NGLister  may  be  downloaded  from  the Subversion repository <URL:http://svn.complete.org/> or from the
       Debian package page <URL:http://packages.debian.org/unstable/news/nglister.html>.

SEE ALSO

       slrn(1), python(1)