view docs/inews.1 @ 165:8ea6b5ddc5a5 noffle

[svn] * src/lock.h,src/lock.c,src/noffle.c: Add lazy lock release. Only release the lock and close the databases if (a) another process signals us SIGUSR1 indicating it wants the lock, or (b) it is explicitly requested by a call to new function Lock_syncDatabases(). When waiting for the lock, SIGUSR1 the holding process every second. This is all an attempt to minimise the number of times we need to close and open the database. When (ha!) the database is replaced by something that can handle multiple simultaneous writers (with appropriate locking) this won't be necessary.
author bears
date Thu, 25 Jan 2001 13:38:31 +0000
parents 1c7303c71f66
children
line wrap: on
line source

.TH inews 1
.\" $Id: inews.1 227 2000-10-26 21:21:13Z bears $
.SH NAME
inews \- Send a Usenet article.

.SH SYNOPSIS

.B inews
[
.B \-D
]
[
.B \-O
]
[
.B \-S
]
[
.I input
]

.SH DESCRIPTION

.I inews
reads a Usenet news article including headers from
the named file or standard input if no file is given.
It adds some headers and performs some checks. If the article
fails the checks (e.g. the article lacks a body, or has no Newsgroups:
line), the article is rejected. Otherwise the article is posted.


.SH OPTIONS

.TP
.B \-D
Debug mode.
.I inews
adds header lines and performs some checks. If the checks are successful,
the article is printed on the standard output and not posted.
.TP
.B \-O
If no
.I Organization:
header is found, and a value for
.I organization
is specified in
.BR noffle.conf (5),
.I inews
will add a
.I Organization:
header using that value. To suppress this behaviour, use the
.B \-O
flag.
.TP
.B "\-h \-A \-V \-W"
For compatibility with inews programs used with other news servers,
.I inews
accepts, but ignores, the ``\fB\-h\fP'', ``\fB\-A\fP'', ``\fB\-V\fP''
and ``\fB\-W\fP'' flags.
.TP
.B \-N
For compatability with inews programs used with other news servers,
the ``\fB\-N\fP'' flag is treated as the ``\fB\-D\fP'' flag.
.TP
.B \-S
Normally, if a file named
.I .signature
exists in the user's home directory,
.I inews
will try to append it to the end of the article. If the file cannot be
read, the article will not be posted.
If the
.B \-S
flag is given, .signature will not be added.

.SH NOTES

.I inews
exits with a zero status if the article was successfully posted, or a
non-zero status if a check fails or posting fails.

.PP
This
.I inews
is supplied with the
.B NOFFLE
news server. It is, in fact, the main
.BR noffle (1)
executable, and the
.I inews
program is just a link to the main
.I noffle
program. If the
.I noffle
program sees it is being executed under the name
.I inews
it adjusts its behaviour accordingly.

.SH FILES

.B NOFFLE
takes its configuration from a configuration file, by default
.I /etc/noffle.conf.
For a description of this file, see
.BR noffle.conf(5).

.SH SEE ALSO

.BR noffle (1),
.BR noffle.conf (5),

.SH AUTHORS

Markus Enzenberger <markus.enzenberger@t-online.de>
.br
Volker Wysk <volker.wysk@student.uni-tuebingen.de>
.br
Jim Hague <jim.hague@acm.org>
.br
Uwe Hermann <uh1763@bingo-ev.de>

1998-2000.