NAME

       nnrpd - NNTP server for on-campus hosts

SYNOPSIS

       nnrpd [ -r reason ] [ -s title padding ] [ -S host ] [ -t ]

DESCRIPTION

       Nnrpd  is  an  NNTP server for newsreaders.  It accepts commands on its standard input and
       responds on its standard output.  It is normally invoked by innd(8) with those descriptors
       attached to a remote client connection.

       Unlike innd, nnrpd supports all NNTP commands for user-oriented reading and posting.

       Nnrpd  uses  the  nnrp.access(5)  file  to  control who is authorized to access the Usenet
       database.  It will also reject connections if the load average is greater than 10.

       On exit, nnrpd will report usage statistics through syslog(3).

       Nnrpd can accept multimedia postings that  follow  the  MIME  standard  as  long  as  such
       postings  are also acceptible as SMTP messages.  See the discussion of the MIME headers in
       inn.conf(5).

OPTIONS

       -r     If the ``-r'' flag is used, then nnrpd will reject the incoming  connection  giving
              reason as the text.  This flag is used by innd when it is paused or throttled.

       -s     As each command is received, nnrpd tries to change its ``argv'' array so that ps(1)
              will print out the command being executed.  To get a full display, the ``-s''  flag
              may  be used with a long string as its argument, which will be overwritten when the
              program changes its title.

       -t     If the ``-t'' flag is used then all client commands and initial responses  will  be
              traced  by reporting them in syslog.  This flag is set by innd under the control of
              the ctlinnd(8) ``trace'' command, and is toggled upon  receipt  of  a  SIGHUP;  see
              signal(2).

       -S     If  the ``-S'' flag is used, then all postings are forwarded to the specified host,
              which should be the master NNTP server.  This flag is set by innd if it is  started
              with the ``-S'' flag.

   PROTOCOL DIFFERENCES
       Nnrpd implements the NNTP commands defined in RFC 977, with the following differences:

       1.     The  ``ihave''  command  is  not  implemented.   Users should be using the ``post''
              command to post articles.

       2      The ``slave'' command is not  implemented.   This  command  has  never  been  fully
              defined.

       3      The  ``list''  command  may  be  followed  by  the  optional word ``active.times'',
              ``distributions'',   ``distrib.pats'',   ``newsgroups'',   ``subscriptions'',    or
              ``overview.fmt''  to  get  a list of when newsgroups where created, a list of valid
              distributions, a file specifying  default  distribution  patterns,  a  one-per-line
              description  of  the  current  set  of  newsgroups,  a  list of the automatic group
              subscriptions, or a listing  of  the  overview.fmt(5)  file.   The  command  ``list
              active'' is equivalent to the ``list'' command.  This is a common extension.

       4.     The  ``xhdr'',  ``authinfo  user'', and ``authinfo pass'' commands are implemented.
              These are based on the reference Unix implementation;  no  other  documentation  is
              available.

       5.     A  new command, ``xpat header range|MessageID pat [morepat...]'', is provided.  The
              first argument is the case-insensitive name of the  header  to  be  searched.   The
              second  argument is either an article range or a single Message-ID, as specified in
              RFC 977.  The third argument is a wildmat(3)-style pattern; if there are additional
              arguments they are joined together separated by a single space to form the complete
              pattern.  This command is similar to  the  ``xhdr''  command.   It  returns  a  221
              response  code, followed by the text response of all article numbers that match the
              pattern.

       6.     The ``listgroup group'' command is provided.  This is a comment extension.   It  is
              equivalent to the ``group'' command, except that the reply is a multi-line response
              containing the list of all article numbers in the group.

       7.     The ``xgtitle [group]'' command is provided.  This extension is used  by  ANU-News.
              It  returns  a 282 reply code, followed by a one-line description of all newsgroups
              that match the pattern.  The default is the current group.

       8.     The ``xover [range]'' command is provided.  It returns a 224 reply  code,  followed
              by the overview data for the specified range; the default is to return the data for
              the current article.

       9.     The ``xpath MessageID'' command is provided; see innd(8).

       10.    The ``date'' command is  provided;  this  is  based  on  the  draft  NNTP  protocol
              revision.   It returns a one-line response code of 111 followed by the GMT date and
              time on the server in the form YYYYMMDDhhmmss.

HISTORY

       Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  Overview support added by Rob
       Robertston  <rob@violet.berkeley.edu>  and  Rich in January, 1993.  This is revision 1.14,
       dated 1996/10/29.

SEE ALSO

       ctlinnd(8), innd(8), inn.conf(5), nnrp.access(5), signal(2), wildmat(3).

                                                                                         NNRPD(8)