| rev |
line source |
|
yuuji@1
|
1 Pine 4.0x Maildir c-client module
|
|
yuuji@1
|
2 ---------------------------------
|
|
yuuji@1
|
3
|
|
yuuji@1
|
4 Written by Mattias Larsson <ml@techno.org> <mta@freeit.com>
|
|
yuuji@1
|
5
|
|
yuuji@1
|
6 This is the second release of my Maildir driver for Pine 4. It is based
|
|
yuuji@1
|
7 on Eric Greens IMAP2bis Maildir driver.
|
|
yuuji@1
|
8
|
|
yuuji@1
|
9 PLEASE NOTE that this driver has only been tested in the IMAP4rev1 daemon
|
|
yuuji@1
|
10 before. It was just put into Pine 4.00, and it looks like it works, but it
|
|
yuuji@1
|
11 has not been extensively tested. It has been running for 8 months in
|
|
yuuji@1
|
12 production in our IMAP4 daemon though.
|
|
yuuji@1
|
13
|
|
yuuji@1
|
14 PLEASE NOTE:
|
|
yuuji@1
|
15
|
|
yuuji@1
|
16 This driver needs to store the UID's of the message in the file somehow. In
|
|
yuuji@1
|
17 the earlier versions of this driver this was done by adding a new maildir
|
|
yuuji@1
|
18 flag (the ,3 flag), however, this solution was not very good since most
|
|
yuuji@1
|
19 other clients could not handle it. Thus I had to find another solution. In
|
|
yuuji@1
|
20 this driver I use a pretty radical method. Any file in the maildir with the
|
|
yuuji@1
|
21 execute bit set has its UID set in the mtime of the file. So you should not
|
|
yuuji@1
|
22 edit the files in here, or in any otherway update the mtime, because then
|
|
yuuji@1
|
23 the UID gets changed. Most clients should not do this, so I think this
|
|
yuuji@1
|
24 solution is compatible with most other clients (if you find one that isn't,
|
|
yuuji@1
|
25 let me know). If you for some reason have to edit a file in the Maildir,
|
|
yuuji@1
|
26 delete the ".uidvalidity" file in the root of the Maildir (ie, the dir where
|
|
yuuji@1
|
27 you find cur/ new/ and tmp/). Alternatively, edit maildir.c and define the
|
|
yuuji@1
|
28 NO_UID_VALIDITY option, which will cause the Maildir to get set new UID's on
|
|
yuuji@1
|
29 every start up. Note that if you are running IMAP and Netscape as a client,
|
|
yuuji@1
|
30 you can't change the UID's, because Netscape do not support the UID validity
|
|
yuuji@1
|
31 flag in the IMAP protocol. So use this with care.
|
|
yuuji@1
|
32
|
|
yuuji@1
|
33 Please edit the maildir.c file in any case. There are 3 options you can
|
|
yuuji@1
|
34 set yourself. The default configuration is not suitable for ISPs. If you are
|
|
yuuji@1
|
35 an ISP, or system with many users, you might want to consider setting some
|
|
yuuji@1
|
36 of the options different.
|
|
yuuji@1
|
37
|
|
yuuji@1
|
38 Ohh, if there are problems compiling it, let me know, and please let me know
|
|
yuuji@1
|
39 what you did to fix it. This thing was developed on Solaris (using both GCC
|
|
yuuji@1
|
40 and SunCC, should work with both), but I haven't tried it on any other
|
|
yuuji@1
|
41 platform. It is also known to compile cleanly on Linux RH5.1
|
|
yuuji@1
|
42
|
|
yuuji@1
|
43 CONFIGURATION
|
|
yuuji@1
|
44 -------------
|
|
yuuji@1
|
45
|
|
yuuji@1
|
46 There are a few configurable options. You find these at the top of the
|
|
yuuji@1
|
47 maildir.c file (and it can be found in imap/src/osdep/unix if I'm not all
|
|
yuuji@1
|
48 mistaken). Right now, two options are configurable. By default it is
|
|
yuuji@1
|
49 configured for ISP use, something that you might want to change if you use
|
|
yuuji@1
|
50 it at home.
|
|
yuuji@1
|
51
|
|
yuuji@1
|
52 HOW TO USE
|
|
yuuji@1
|
53 ----------
|
|
yuuji@1
|
54
|
|
yuuji@1
|
55 Use it as any other c-client driver. There is some option you want to change
|
|
yuuji@1
|
56 if you want all folders to be created as Maildirs (and I can't remember what
|
|
yuuji@1
|
57 the option is from the top of my head). Read the pine documentation.
|
|
yuuji@1
|
58
|
|
yuuji@1
|
59 CHANGES
|
|
yuuji@1
|
60 -------
|
|
yuuji@1
|
61
|
|
yuuji@1
|
62 Rel 4. Coredump problem fixed. In release 3 I decided to user the sparep
|
|
yuuji@1
|
63 in the message cache so no patching of mail.h would be necessary,
|
|
yuuji@1
|
64 however, PINE uses this pointer internally for other things, causing
|
|
yuuji@1
|
65 coredumps when used with the Rel 3. patch.
|
|
yuuji@1
|
66
|
|
yuuji@1
|
67 Rel 3. New way of storing UID's (compatible with ,2 clients).
|
|
yuuji@1
|
68 Multiple inbox patches applied
|
|
yuuji@1
|
69
|
|
yuuji@1
|
70 Rel 2. Pine 4 changes.
|
|
yuuji@1
|
71
|
|
yuuji@1
|
72 Rel 1. Imap4rev 1 driver
|
|
yuuji@1
|
73
|
|
yuuji@1
|
74 FINAL NOTES
|
|
yuuji@1
|
75 -----------
|
|
yuuji@1
|
76
|
|
yuuji@1
|
77 I'll try to maintain and release new versions as soon as I have time over,
|
|
yuuji@1
|
78 which unfortunately does not happen very often in this business ;)
|
|
yuuji@1
|
79
|
|
yuuji@1
|
80 You can (might) find newer versions of this driver at:
|
|
yuuji@1
|
81
|
|
yuuji@1
|
82 http://www.freeit.com/mta/
|
|
yuuji@1
|
83
|
|
yuuji@1
|
84
|
|
yuuji@1
|
85 Regards,
|
|
yuuji@1
|
86 Daniel Mattias Larsson
|
|
yuuji@1
|
87
|
|
yuuji@1
|
88 e-mail: ml@techno.org
|
|
yuuji@1
|
89 ph: +46-707-268785
|
|
yuuji@1
|
90 snail-mail:
|
|
yuuji@1
|
91 Industrivagen 4
|
|
yuuji@1
|
92 SE-194 77 Upplands Vasby
|
|
yuuji@1
|
93 SWEDEN
|
|
yuuji@4
|
94 Pine 4.0x Maildir c-client module
|
|
yuuji@4
|
95 ---------------------------------
|
|
yuuji@4
|
96
|
|
yuuji@4
|
97 Written by Mattias Larsson <ml@techno.org> <mta@freeit.com>
|
|
yuuji@4
|
98
|
|
yuuji@4
|
99 This is the second release of my Maildir driver for Pine 4. It is based
|
|
yuuji@4
|
100 on Eric Greens IMAP2bis Maildir driver.
|
|
yuuji@4
|
101
|
|
yuuji@4
|
102 PLEASE NOTE that this driver has only been tested in the IMAP4rev1 daemon
|
|
yuuji@4
|
103 before. It was just put into Pine 4.00, and it looks like it works, but it
|
|
yuuji@4
|
104 has not been extensively tested. It has been running for 8 months in
|
|
yuuji@4
|
105 production in our IMAP4 daemon though.
|
|
yuuji@4
|
106
|
|
yuuji@4
|
107 PLEASE NOTE:
|
|
yuuji@4
|
108
|
|
yuuji@4
|
109 This driver needs to store the UID's of the message in the file somehow. In
|
|
yuuji@4
|
110 the earlier versions of this driver this was done by adding a new maildir
|
|
yuuji@4
|
111 flag (the ,3 flag), however, this solution was not very good since most
|
|
yuuji@4
|
112 other clients could not handle it. Thus I had to find another solution. In
|
|
yuuji@4
|
113 this driver I use a pretty radical method. Any file in the maildir with the
|
|
yuuji@4
|
114 execute bit set has its UID set in the mtime of the file. So you should not
|
|
yuuji@4
|
115 edit the files in here, or in any otherway update the mtime, because then
|
|
yuuji@4
|
116 the UID gets changed. Most clients should not do this, so I think this
|
|
yuuji@4
|
117 solution is compatible with most other clients (if you find one that isn't,
|
|
yuuji@4
|
118 let me know). If you for some reason have to edit a file in the Maildir,
|
|
yuuji@4
|
119 delete the ".uidvalidity" file in the root of the Maildir (ie, the dir where
|
|
yuuji@4
|
120 you find cur/ new/ and tmp/). Alternatively, edit maildir.c and define the
|
|
yuuji@4
|
121 NO_UID_VALIDITY option, which will cause the Maildir to get set new UID's on
|
|
yuuji@4
|
122 every start up. Note that if you are running IMAP and Netscape as a client,
|
|
yuuji@4
|
123 you can't change the UID's, because Netscape do not support the UID validity
|
|
yuuji@4
|
124 flag in the IMAP protocol. So use this with care.
|
|
yuuji@4
|
125
|
|
yuuji@4
|
126 Please edit the maildir.c file in any case. There are 3 options you can
|
|
yuuji@4
|
127 set yourself. The default configuration is not suitable for ISPs. If you are
|
|
yuuji@4
|
128 an ISP, or system with many users, you might want to consider setting some
|
|
yuuji@4
|
129 of the options different.
|
|
yuuji@4
|
130
|
|
yuuji@4
|
131 Ohh, if there are problems compiling it, let me know, and please let me know
|
|
yuuji@4
|
132 what you did to fix it. This thing was developed on Solaris (using both GCC
|
|
yuuji@4
|
133 and SunCC, should work with both), but I haven't tried it on any other
|
|
yuuji@4
|
134 platform. It is also known to compile cleanly on Linux RH5.1
|
|
yuuji@4
|
135
|
|
yuuji@4
|
136 CONFIGURATION
|
|
yuuji@4
|
137 -------------
|
|
yuuji@4
|
138
|
|
yuuji@4
|
139 There are a few configurable options. You find these at the top of the
|
|
yuuji@4
|
140 maildir.c file (and it can be found in imap/src/osdep/unix if I'm not all
|
|
yuuji@4
|
141 mistaken). Right now, two options are configurable. By default it is
|
|
yuuji@4
|
142 configured for ISP use, something that you might want to change if you use
|
|
yuuji@4
|
143 it at home.
|
|
yuuji@4
|
144
|
|
yuuji@4
|
145 HOW TO USE
|
|
yuuji@4
|
146 ----------
|
|
yuuji@4
|
147
|
|
yuuji@4
|
148 Use it as any other c-client driver. There is some option you want to change
|
|
yuuji@4
|
149 if you want all folders to be created as Maildirs (and I can't remember what
|
|
yuuji@4
|
150 the option is from the top of my head). Read the pine documentation.
|
|
yuuji@4
|
151
|
|
yuuji@4
|
152 CHANGES
|
|
yuuji@4
|
153 -------
|
|
yuuji@4
|
154
|
|
yuuji@4
|
155 Rel 4. Coredump problem fixed. In release 3 I decided to user the sparep
|
|
yuuji@4
|
156 in the message cache so no patching of mail.h would be necessary,
|
|
yuuji@4
|
157 however, PINE uses this pointer internally for other things, causing
|
|
yuuji@4
|
158 coredumps when used with the Rel 3. patch.
|
|
yuuji@4
|
159
|
|
yuuji@4
|
160 Rel 3. New way of storing UID's (compatible with ,2 clients).
|
|
yuuji@4
|
161 Multiple inbox patches applied
|
|
yuuji@4
|
162
|
|
yuuji@4
|
163 Rel 2. Pine 4 changes.
|
|
yuuji@4
|
164
|
|
yuuji@4
|
165 Rel 1. Imap4rev 1 driver
|
|
yuuji@4
|
166
|
|
yuuji@4
|
167 FINAL NOTES
|
|
yuuji@4
|
168 -----------
|
|
yuuji@4
|
169
|
|
yuuji@4
|
170 I'll try to maintain and release new versions as soon as I have time over,
|
|
yuuji@4
|
171 which unfortunately does not happen very often in this business ;)
|
|
yuuji@4
|
172
|
|
yuuji@4
|
173 You can (might) find newer versions of this driver at:
|
|
yuuji@4
|
174
|
|
yuuji@4
|
175 http://www.freeit.com/mta/
|
|
yuuji@4
|
176
|
|
yuuji@4
|
177
|
|
yuuji@4
|
178 Regards,
|
|
yuuji@4
|
179 Daniel Mattias Larsson
|
|
yuuji@4
|
180
|
|
yuuji@4
|
181 e-mail: ml@techno.org
|
|
yuuji@4
|
182 ph: +46-707-268785
|
|
yuuji@4
|
183 snail-mail:
|
|
yuuji@4
|
184 Industrivagen 4
|
|
yuuji@4
|
185 SE-194 77 Upplands Vasby
|
|
yuuji@4
|
186 SWEDEN
|
