KNEWSD(1) UNIX System V (1996) KNEWSD(1)
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]
Return the head and/or body of the current or the
specified article. Message-id lookups are not
supported.
GROUP newsgroup
Enters the given newsgroup.
HELP
Gives a list of the implemented commands.
LIST [active | newsgroups]
Lists the active file or the newsgroups file.
NEXT
Changes the current article pointer to the next article
POST
Post an article via the specified posting agent. If
none has been specified, the reply will be '440 Posting
not implemented.'
QUIT
Makes knewsd exit.
STAT number
Sets the current article pointer.
XOVER range
Returns the overview data for the specified range of
articles.
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
Page 1 (printed 8/26/99)
KNEWSD(1) UNIX System V (1996) KNEWSD(1)
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)
Page 2 (printed 8/26/99)
