imapext-2007

view README.maildir @ 4:d741b3ecc917

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

UW-IMAP'd extensions by yuuji