forked from milter-manager/milter-manager
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
176 lines (131 loc) · 4.61 KB
/
README
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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
# -*- rd -*-
= README --- milter manager: a milter to use milters effectively.
== Name
milter manager
== Site
((<URL:http://milter-manager.sourceforge.net/>))
== License
Use the following rules:
* Files that describe their license: their license
* Commands: GPL3(license/gpl.txt)
* Documents: GFDL(license/fdl.txt)
* Web interface: AGPL3(license/agpl.txt)
* Images: Public Domain
* Libraries: LGPL3(license/lgpl.txt)
Here is a concrete list:
* Files that describe their license:
* milter/core/milter-memory-profile.c: LGPL2+
* binding/ruby/lib/milter/compatible.rb: Ruby's
* admin/vendor/plugins/restful-auth/: MIT
* Commands: GPL3
* src/*
* tool/*
* Documents: GFDL
* README, README.ja
* doc/*
* Web interface: AGPL3
* admin/**/*
* Images: Public Domain
* doc/*.svg, doc/*.png, html/*.svg, html/*.png
* Libraries: LGPL3
* others than those above
== milter manager
milter manager is a milter to use multiple milters
effectively.
If milter manager is introduced, milter manager
administrates milters instead of MTA. The has some
advantages:
* reduce milter administration cost
* combine milters flexibly
See ((<Introduction|"doc/introduction.rd">)) for more details.
== Dependencies
* MTA that supports milter
* Sendmail >= 8.13.8
* Postfix >= 2.3.3
* GLib >= 2.12.3
* Ruby >= 1.8.5
* UN*X OS
* Linux(Debian GNU/Linux, Ubuntu, CentOS)
* FreeBSD, NetBSD
* Solaris
=== Optional dependencies
* ((<Cutter: unit testing framework for C|URL:http://cutter.sourceforge.net/>))
>= 1.0.6
It is needed for 'make check' and 'make coverage'.
* LCOV: graphical front-end for GCC's coverage testing tool gcov
It is needed for 'make coverage'.
((<LCOV - the LTP GCOV extension|URL:http://ltp.sourceforge.net/coverage/lcov.php>))
* RRDtool (It's better that bundled Ruby bindings are also installed)
It is needed for milter-manager-log-analyzer.
((<RRDtool|URL:http://oss.oetiker.ch/rrdtool/>))
== Install
See ((<Install|"doc/install.rd">)).
== Configuration
See ((<Configuration|"doc/configuration.rd">)).
== Usage
milter-manager command is installed into sbin/ not
bin/. In most cases, normal user doesn't include sbin/ in
PATH. You will need to use absolute path.
If you don't specify --prefix option for configure script,
milter-manager is installed into /usr/local/sbin/. You can
run milter-manager like the following:
% /usr/local/sbin/milter-manager --help
Available options are shown if installation is succeeded.
See ((<milter-manager|"doc/milter-manager.rd">)) for more details.
== Tools
milter manager includes some useful tools. They are
installed into bin/.
* ((<milter-test-server|"doc/milter-test-server.rd">)): It
talks MTA side milter protocol. It can be used for
testing a milter without MTA.
* ((<milter-test-client|"doc/milter-test-client.rd">)): It
is a milter that just shows received data from MTA. It
can be used for confirming what data is sent from MTA.
* ((<milter-performance-check|"doc/milter-performance-check.rd">)):
It is a SMTP client that measures MTA performance.
* ((<milter-manager-log-analyzer|"doc/milter-manager-log-analyzer.rd">)):
It analyzes log of milter-manager and visualizes
behavior of milters registered to milter-manager.
== Mailing list
There is
((<milter-manager-users-en|URL:https://lists.sourceforge.net/lists/listinfo/milter-manager-users-en>))
mailing list. Questions and bug reports are accepted on
it. New release announce is also done on the mailing
list. If you are using milter manager, it's a good idea that
you subscribe the mailling list.
== Source code
The latest source is available from the Git repository:
% git clone https://github.com/milter-manager/milter-manager.git
== Thanks
* OBATA Akio: reported a bug.
* Павел Гришин: reported bugs.
* Fumihisa Tonaka:
* reported bugs.
* suggested new features.
* sgyk: reported bugs.
* Tsuchiya: reported bugs.
* Syunsuke Komma: reported a bug.
* Yuto Hayamizu:
* cleaned test.
* added useful features for creating milter by Ruby.
* gorimaru: suggested usage improvements.
* ZnZ:
* fixed typos.
* reported useful advises.
* Antuan Avdioukhine: suggestions.
* SATOH Fumiyasu:
* reported bugs.
* improved Solaris support.
* ROSSO: reported a bug.
* akira yamada:
* reported a bug.
* suggested about Debian package.
* Kenji Shiono:
* reported bugs.
* suggested new features.
* Jordao:
* reported a bug.
* Mitsuru Ogino:
* reported bugs.
* moto kawasaki:
* added /etc/rc.conf.local loading support on FreeBSD.