--- name: "in.nnrpd" section: "8" platform: "linux" package: "inn" version: "1:1.7.2q-52" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/in.nnrpd" --- # in.nnrpd(8) NNTP server for on-campus hosts ## 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)](/innd/8.md) 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)](/nnrp.access/5.md) 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)](/syslog/3.md). *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)](/inn.conf/5.md). ## 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)](/ps/1.md) 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)](/ctlinnd/8.md) \`\`trace'' command, and is toggled upon receipt of a SIGHUP; see [*signal*(2)](/signal/2.md). - **-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)](/overview.fmt/5.md) 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)](/wildmat/3.md)-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)](/innd/8.md). - 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 \ for InterNetNews. Overview support added by Rob Robertston \ and Rich in January, 1993. This is revision 1.14, dated 1996/10/29. ## SEE ALSO [ctlinnd(8)](/ctlinnd/8.md), [innd(8)](/innd/8.md), [inn.conf(5)](/inn.conf/5.md), [nnrp.access(5)](/nnrp.access/5.md), [signal(2)](/signal/2.md), [wildmat(3)](/wildmat/3.md).