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
|
<!-- DSTART -->
<!-- -->
<!-- maildrop - mail delivery agent with filtering abilities -->
<!-- -->
<!-- Copyright 1998-1999, Double Precision Inc. -->
<!-- -->
<!-- This program is distributed under the terms of the GNU General Publi -->
<!-- License. See COPYING for additional information. -->
<!-- DEND -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>maildrop 0.75</title>
<!-- SECTION 1 -->
</head>
<body>
<h1>maildrop 0.75</h1>
<p>Maildrop 0.75 includes several bug fixes to the userdb scripts, however the
main change in 0.75 is a different installation layout.</p>
<p>Maildrop versions 0.74 and earlier used the following installation layout.
Typically, the following files were installed in the directory
<tt>/usr/local/bin</tt>:</p>
<p><tt>/usr/local/bin/dotlock</tt><br>
<tt>/usr/local/bin/maildrop</tt><br>
<tt>/usr/local/bin/reformail</tt><br>
<tt>/usr/local/bin/reformime</tt> - core maildrop binaries</p>
<p><tt>/usr/local/bin/maildirmake</tt> - soft link to
<tt>maildrop.maildirmake</tt><br>
<tt>/usr/local/bin/maildrop.maildirmake</tt></p>
<p><tt>/usr/local/bin/makedat</tt> - soft link to<tt>
maildrop.makedat</tt><br>
<tt>/usr/local/bin/maildrop.makedat</tt> - optionally installed if GDBM/DB
support is selected during configuration</p>
<p><tt>/usr/local/bin/deliverquota</tt> - soft link to<tt>
maildrop.deliverquota</tt><br>
<tt>/usr/local/bin/maildrop.deliverquota</tt> - optionally installed if
maildir quota support is selected during configuration</p>
<p><tt>/usr/local/bin/makeuserdb</tt> - soft link to
<tt>maildrop.makeuserdb</tt><br>
<tt>/usr/local/bin/pw2userdb</tt> - soft link to
<tt>maildrop.pw2userdb</tt><br>
<tt>/usr/local/bin/userdb</tt> - soft link to <tt>maildrop.userdb</tt><br>
<tt>/usr/local/bin/maildrop.makeuserdb</tt><br>
<tt>/usr/local/bin/maildrop.pw2userdb</tt><br>
<tt>/usr/local/bin/maildrop.userdb</tt> - optional scripts installed if userdb
support is selected during configuration<br>
<tt>/usr/local/man</tt> - various manual pages were installed underneath this
directory.</p>
<p>There was a reason why I initially decided to use this particular
installation layout. At least, I think I had one.</p>
<p>Although I haven't received any comments on this layout, I believe that
this layout is not very convenient, and may be confusing. So I've decided to
try a new installation layout starting with maildrop 0.75. My goals were:</p>
<ul>
<li>A logical, straightforward layout</li>
<li>Try to avoid breaking any existing stuff</li>
<li>Allow easier management. For example, permit a quick and painless way to
roll back to a previous release of <tt>maildrop</tt> (for some future
releases, of course).</li>
</ul>
<p>Maildrop 0.75 and onward will use the following installation layout by
default:</p>
<p><tt>/usr/local/lib/maildrop/bin</tt> - all base and optional binaries will
be installed here</p>
<p><tt>/usr/local/lib/maildrop/man</tt> - all manual pages will be installed
here</p>
<p><tt>/usr/local/lib/maildrop/html</tt> - all HTML versions of manual pages,
and additional documentation, will be installed here.</p>
<p>Soft links in <tt>/usr/local/bin</tt>. The installation script will install
the following soft links in the <tt>/usr/local/bin</tt> directory. The
following soft links will point to the binaries that are installed in the
<tt>/usr/local/lib/maildrop/bin</tt> directory:</p>
<p><tt>/usr/local/bin/maildrop</tt><br>
<tt>/usr/local/bin/reformail</tt><br>
<tt>/usr/local/bin/reformime</tt><br>
<tt>/usr/local/bin/dotlock</tt><br>
<tt>/usr/local/bin/maildirmake</tt><br>
<tt>/usr/local/bin/makedat</tt><br>
<tt>/usr/local/bin/deliverquota</tt><br>
<tt>/usr/local/bin/makeuserdb</tt><br>
<tt>/usr/local/bin/pw2userdb</tt><br>
<tt>/usr/local/bin/userdb</tt><br>
</p>
<p>Configuration switches that select whether or not certain optional binaries
are installed will remain the same.</p>
<p>Basically, anything that expects to find things in <tt>/usr/local/bin</tt>
should continue to work.</p>
<p>However, when you are ready to install a later release of maildrop, you can
simply move your current <tt>/usr/local/lib/maildrop</tt> directory before
installing the later release. In the event that you need to back out to the
previous version of maildrop, you can do that simply by removing the newly
installed <tt>/usr/local/lib/maildrop</tt> directory, and moving the previous
one in its place.</p>
<p>I think that this is a definite improvement from the previous layout.</p>
<h2>Upgrading from maildrop 0.74 and earlier</h2>
<p>If you compile and install maildrop 0.74 from the original source code
tarball, you can proceed to configure, compile, and install maildrop as usual.
You can use the <tt>--prefix</tt> option to the <tt>configure</tt> script to
change the main installation directory from <tt>/usr/local/lib/maildrop</tt>
to something else. If your previous version of maildrop was not installed in
the default directory <tt>/usr/local/bin</tt>, you can use the
<tt>--bindir</tt> option to the configure script to specify your non-default
installation directory.</p>
<p><tt>make install</tt> should be able to create the correct soft links.
After running <tt>make install</tt>, or <tt>make install-strip</tt>, you will
need to manually perform the following steps:</p>
<ul>
<li>Manually remove any old maildrop binaries from <tt>/usr/local/bin</tt>,
such as <tt>maildrop.makedat</tt>, <tt>maildrop.deliverquota</tt>, and
others. Anything <tt>maildrop.*</tt> can be removed.</li>
<li>New manual pages are installed underneath the main
<tt>/usr/local/lib/maildrop</tt> directory. You will need to remove old
manual pages from the <tt>/usr/local/man</tt> directory. Find all files
underneath <tt>/usr/local/man</tt> that begin with "maildrop". You will
also need to look for a corresponding soft link that points to each manual
page.</li>
<li>Configure your <tt>man(1)</tt> command to search
<tt>/usr/local/lib/maildrop/man</tt> for manual pages, which is where
maildrop's manual pages are now installed. In most cases, you need to
simply add the path <tt>/usr/local/lib/maildrop/man</tt> to the MANPATH
environment variable. If you use the Bourne or Bash shells, simply add the
following code to <tt>/etc/profile</tt>:<br>
<br>
<tt>MANPATH="/usr/local/lib/maildrop:$MANPATH"</tt><br>
<tt>export MANPATH</tt></li>
</ul>
<h2>Upgrading binary RPMS for Red Hat Linux</h2>
<p>I recommend that instead of using the rpm -U command to upgrade your binary
RPM, you should first remove the old maildrop rpm, using rpm -e, then install
the new RPM using rpm -i.</p>
<p>The binary RPM takes care of setting the MANPATH variable. Also, note that
the binary RPM installes the HTML version of manual pages, plus additional
documentation, in <tt>/usr/doc</tt> instead of
<tt>/usr/local/lib/maildrop/html</tt>.</p>
<p></p>
<p></p>
</body>
</html>
|
