.TH PMDAEMON 1 "PGP Moose"
.\"@(#)pmdaemon.1	1.3 (PGP MOOSE) 98/11/26
.SH NAME
pmdaemon \- Automatically check postings to
newsgroups
.SH SYNOPSIS
.BI pmdaemon article 
.SH DESCRIPTION
.I Pmdaemon
is invoked by \f2INN\fP as articles arrive in
particular newsgroups. When an article is in a
newsgroup that is being monitored, \f3pmcheck\fP(1)
is run to check the X-Auth: header for that
group. An article which fails the check will
cause a mail message to be sent to the configured
destination for that newsgroup, and can
optionally issue an automatic cancellation
message. Messages are also checked for any
individual's authorisations, and if the message
fails such a check mail is sent to the address
given on the X-Auth: line.
.PP
To arrange for \f3pmdaemon\fP to be invoked, an
entry similar to the following should be added to
the \f3newsfeeds\fP(5) file.
.br
.nf
.na
PGPMoose!\
	:!*,local,sci.crypt.research,\
	misc.test.moderated,comp.binaries.geos,\
	comp.os.linux.announce,comp.std.c++,comp.sources.misc\
        :Tp:/home/ggr/pgpmoose/pmdaemon %s
.ad
.fi
.PP
A configuration file, by default called
\fCcheckedgroups\fP, determines which of these
newsgroups are actually being controlled.
Messages in uncontrolled groups are nevertheless
scanned for individuals' authentications.  This
configuration file must contains a sorted list of
lines, each with three tab-separated fields.  The
first field is the name of a controlled
newsgroup. The second is a keyword specifying the
action to be taken upon receipt of an article
which fails the check; currently the supported
possibilities are \f2email\fP and \f2cancel\fP
which each send mail, but one also cancels the
posting automatically, or \f2ignore\fP, which can
be used as a placeholder if a newsgroup is
temporarily being ignored. The third field is an
email address to which the mail notification will
be sent.
.PP
The mail gives the output of the \f3pmcheck\fP
command, which will detail the reason for
rejection of the article, the full
article itself, and a preformatted cancel message
which can be posted (after approving it of
course) to cancel the article. If the article is
automatically cancelled, the cancellation is
approved by a special user, whose key is
distributed with pmdaemon.
.PP
There are certain kinds of messages which are
ignored by pmdaemon. These are: all cancel
messages, so that two PGP Moose daemons can never
get into an argument with each other; control
messages, and all messages approved by
(tale|newgroups-request|group-admin)@isc.org;
messages approved by people entered in the
\f2othermoderators\fP file.
.PP
The
\f2othermoderators\fP file lists newsgroups and
corresponding approval lines for groups where some
of the moderators use the PGP Moose, and others
don't (but should...). It can also be used to
allow cooperating groups to approve posts to each
other's groups.
.PP
\f2Pmdaemon\fP keeps a log of its actions, by
default in a file called \f3mooselog\fP. This
must be cleaned up manually.
.SH FILES
The \f3checkedgroups\fP, \f3mooselog\fP and
\f3othermoderators\fP files
live in a configurable directory. There is also a
special keyring, \f2pmcancel.pgp\fP which
provides the PGP userid which authenticates
cancel messages.
.SH SEE ALSO
.IR pmapp (1),
.IR pmcheck (1)
.SH AUTHOR
Greg Rose, RoSecure Software.