NNTPD

Synopsis

NNTPD [/?] [/ACCESSLEVEL number] [/PATHIDENTITY string]] socket

Description

NNTPD provides NNTP service, accepting NNTP commands on its input and sending NNTP responses and message data on its output. If no socket is specified as an argument, it uses its standard input and standard output for input and output. Otherwise, it uses the named socket, which it closes when it has finished with it. The IP address and TCP port number on which NNTP service is thus provided is determined by its parent process, not NNTPD itself. Conventionally, the port number is 119 and the IP address is one that is reachable by Internet at large.

NNTPD expects the news spool to be stored in the standard format below the current directory of the dæmon.

NNTPD is designed to be spawned on demand by TCPSRUN. It can also be spawned by INETD, although the control of client access levels based upon the client's IP address, which TCPSRUN does, will be unavailable as a consequence.

Where client access is denied, NNTPD simply exits immediately, closing the socket. With any other access level, normal NNTP service is provided.

NNTPD writes log information to its standard error.

Service provided

NNTPD provides service in two modes. In both modes, the NNTP verbs noop, help, date, and quit are available. Each mode supports further additional verbs.

NNTPD, like many other NNTP servers, provides a variation from the documented protocol (which in practice is respected far more widely in the breach than the observance). In particular, it varies in the following ways:

NNTPD canonicalizes posted messages and requires messages transferred from peer NetNews nodes to already be in canonical form. After a message has been canonicalized, or checked to see that it is already in canonical form, NNTPD imposes the following restrictions:

To (canonical form) messages that satisfy these requirements, NNTPD makes further modifications:

Example RUN file

A "TCPService.RUN" run file, for NNTPD to be spawned by TCPSRUN, would typically look similar to:

  chdir %NEWSROOT%\
  program %APPS%\JdeBP\IU\Bin\NNTPD.exe
  argument NNTPD
  argument %3

TCPSRUN itself would be invoked under RUNSVC, the Service Manager in the OS/2 Command Line Utilities version 2.2, with a run file similar to:

  chdir %_BOOT%:\Config\Services\%1
  program %APPS%\JdeBP\IU\bin\TCPSRun.exe
  argument TCPSRun
  argument 0.0.0.0
  argument nntp
  argument TCPService.RUN

Command-specific options

/PATHIDENTITY
Specify the path identity used by the server, in the Path: and XRef: headers.

The Internet Utilities are © Copyright Jonathan de Boyne Pollard. "Moral" rights are asserted.