summaryrefslogtreecommitdiff
path: root/sys/man/1/mlmgr
blob: 07de95d618aabae640edf15ad371448ef93c272f (plain)
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.TH MLMGR 1
.SH NAME
ml, mlmgr, mlowner \-  unmoderated mailing lists
.SH SYNOPSIS
.B upas/mlmgr -c
.I listname
.PP
.B upas/mlmgr -ar
.I listname
.I address
.PP
.B upas/ml
[
.B -r 
.I replyto-address
]
.I addressfile
.I listname
.PP
.B upas/mlowner
.I addressfile
.I listname
.SH DESCRIPTION
.I Mlmgr
creates and updates unmoderated mailing lists.
The
.B -c
option creates mail directories for both
.I listname
and
.IB listname -owner\f1,\fP
each containing a
.B pipeto
file.
Messages mailed to
.I listname
are sent to all members of the mailing list.
Any
.B Reply-to:
and
.B Precedence:
fields are
removed from the messages and new ones are added
directing replies to
.I listname
and specifying bulk precedence.  The envelope address for
error replies is set to
.BR /dev/null .
.PP
The mailing list membership is the file
.BR /mail/box/\fIlistname\fP/address-list .
This file is an add/remove log.  Each line
represents a single address.  Lines beginning
with a hash
.RB ( # )
are comments.
Lines beginning with an exclamation point
.RB ( ! )
are removals.
All other lines are additions.
.PP
Addition and removal entries can be appended using the
.B -a
and
.B -r
options to
.IR mlmgr .
However, they are normally appended as a consequence of
user requests.
.PP
To be added or removed from the list, a user
may send a message to
.IB listname -owner
containing a key word in
the header or body.  The key words are:
.IP
subscribe - add my
.B From:
address to the list
.IP
remove - remove my
.B From:
address from the list
.IP
unsubscribe - remove my
.B From:
address from the list
.PP
Addition and removal events cause notification messages to
be sent to the added/removed address.   In the case of
addition, the message describes how to be removed.
.PP
.I Ml
and
.I mlowner
are the programs that receive messages for
.I listname
and
.IB listname -owner
respectively.
Appropriate calls to them are inserted in the
.B pipeto
files created by
.IR mlmgr .
.PP
.IR Ml 's
.B -r
option
sets the
.B Reply-to:
field in the mail sent out by
.I ml.
.SH FILES
.TF /mail/box/\fI<listname>\fP/address-list
.TP
.B  /mail/box/\fI<listname>\fP
list's mailbox directory
.TP
.B /mail/box/\fI<listname>\fP-owner
owner's mailbox directory
.TP
.B  /mail/box/\fI<listname>\fP/address-list
log of mailing list deletions and additions
.SH SOURCE
.TP
.B /sys/src/cmd/upas/ml
.SH "SEE ALSO"
.IR aliasmail (8),
.IR faces (1),
.IR filter (1),
.IR mail (1),
.IR marshal (1),
.IR nedmail (1),
.IR qer (8),
.IR rewrite (6),
.IR send (8),
.IR smtp (8),
.IR upasfs (4)