aboutsummaryrefslogtreecommitdiffstats
path: root/debian/whitelist.5
blob: d12924316a4badb173bd2bd331340d208414a83b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
.\" wing requests are required for all man pages.
.Dd July 23, 2000
.Os Debian GNU/Linux
.Dt whitelist 5
.Sh NAME
.Nm pygs
.Nd the PYthon Gateway Script
.Sh SYNOPSIS
pygs 
-t recipient@domain1
-s sender@domain2
[-e envelope@domain3]
[-d]
[-T]
[-V]
[-l logfile]
[-w whitelist]
[-h]
.Sh DESCRIPTION
NOTE: this man page is to be continued :)

pygs read from stdin a nntp article, sending it to recipient@domain1 a rfc822 compliant email setting Resent-Sender: sender@domain2 and envelope envelope@domain3 if exists, else sender@domain2.
.Sh OPTIONS
.Tp 0.5i
.B \-t 

\" The following requests should be uncommented and
.\" used where appropriate.  This next request is
.\" for sections 2 and 3 function return values only.
.\" .Sh RETURN VALUES
.\" This next request is for sections 1, 6, 7 & 8 only
.\" .Sh ENVIRONMENT
.\" .Sh FILES
.Sh EXAMPLES
There is some documetation in /urs/share/doc/pyg

I created mailgate user (moderator of local.moderated ng).
Every article posted in local.moderated is sent to mailgate, 
in its .procmailrc I've put:

.Bd
.Li :0 bhc
.Li \ * ^To: *local-moderated
.Li | $HOME/pygs -t kalfa@localhost -e mailgate@students.cs.unibo.it -s 'cosimo@students.cs.unibo.it'
.Ed

where kalfa@localhost is the recipient (it usually is a mailing list)

an header extract from kalfa@localhost mbox:

From mailgate@students.cs.unibo.it
From: whosentnntparticle@domain4
To: kalfa@localhost
Resent-Sender: cosimo@students.cs.unibo.it

note that sender and envelope are different. rfc822 says that Sender: have to be a human user (not a program or similia). envelope can mailgate user.

.

.\" This next request is for sections 1, 6, 7 & 8 only
.\"     (command return values (to shell) and
.\"       fprintf/stderr type diagnostics)
.\" .Sh DIAGNOSTICS
.\" The next request is for sections 2 and 3 error
.\" and signal handling only.
.\" .Sh ERRORS
.\" .Sh SEE ALSO
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
Cosimo Alfarano <alfarano@students.cs.unibo.it>
.Sh BUGS
Boh. send any bug to the author
.An , please.