NAME¶

knewsd - a tiny nntp demon

SYNOPSIS¶

knewsd [ options ]

DESCRIPTION¶

Knewsd is intended to be used with knews(1) to read news (in)directly from the spool directory or even from a mail folder hierarchy. It reads NNTP commands from standard input and writes replies to standard output. The following commands are implemented:

ARTICLE [number]
BODY [number]
HEAD [number]

GROUP newsgroup

HELP

LIST [active | newsgroups]

NEXT

POST

QUIT

STAT number

XOVER range

Knewsd implements the 'xover' command either by using the overview files if present, or creating overview records on the fly, or a combination of both if the overview file is incomplete. In the latter case, if the -update flag is given, knewsd will update the overview files.

OPTIONS¶

There is no need to spell out the entire option name, it is sufficient to give a unique prefix, such as -a for -active.

-spool directory

This is the spool directory. It must be specified, either at compile time or at run time.

-active file

This is the active file containing the newsgroups and the high and low article counts. If this is not specifed, knews must be told not to try to read the active file.

-newsgroups file

This is the newsgroups file containing the group descriptions. It's entirely optional.

-overview dir

This can be used if the overview files reside in a different directory hierarchy than the spool directory.

-update

If this is set, knewsd will (try to) update any incomplete overview files it encounters. Not a good idea if you're reading a system wide spool directory.

-postingagent agent

If this is set, the 'agent' will be used to post articles. A possible agent is 'exec inews -h'. This command is interpreted by the shell, and it is important that it is exec'ed, so that knewsd may kill it on a broken pipe to prevent posting of duplicate or truncated articles. Knewsd will warn about this on startup.

AUTHOR¶

This software is Copyright 1995, 1996 by Karl-Johan Johnsson.

SEE ALSO¶

knews(1), inews(1)