tobias/docker-offlineimap
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

/offlineimap/head: changeset 164

Browse Source 
Added profile mode (-P) and updated the documentation with it.
This commit is contained in:
jgoerzen 2002-07-23 02:48:15 +01:00
parent 95e96a3deb
commit 73bf6b6f36
9 changed files with 509 additions and 387 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
offlineimap/head/debian/changelog
View File

@ -6,6 +6,7 @@ offlineimap (3.0.4) unstable; urgency=low
* Manual: added UW IMAPD example with references from docwhat@gerf.org.
* New UI modules: Noninteractive.Basic and Noninteractive.Quiet.
Fixes [complete.org #14].
* Added per-thread profiling support to aid in debugging.
-- John Goerzen <jgoerzen@complete.org> Sun, 21 Jul 2002 16:09:42 -0500

31
offlineimap/head/manual.html
View File

@ -25,7 +25,7 @@
<hr>
<!-- Creator : groff version 1.17.2 -->
<!-- CreationDate: Sun Jul 21 20:54:05 2002 -->
<!-- CreationDate: Mon Jul 22 15:46:54 2002 -->
<a name="NAME"></a>
<h2>NAME</h2>
<table width="100%" border=0 rules="none" frame="void"
@ -40,10 +40,10 @@ OfflineIMAP - Powerful IMAP/Maildir synchronization and reader support</td></tab
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>offlineimap</b> [ <b>-1</b> ] [ <b>-a</b>
<i>accountlist</i> ] [ <b>-c</b> <i>configfile</i> ]<br>
[ <b>-d</b> ] [ <b>-o</b> ] [ <b>-u</b> <i>interface</i>
]</td></table>
<b>offlineimap</b> [ <b>-1</b> ] [ <b>-P</b>
<i>profiledir</i> ] [ <b>-a</b> <i>accountlist</i> ] [
<b>-c</b> <i>configfile</i> ] [ <b>-d</b> ] [ <b>-o</b> ] [
<b>-u</b> <i>interface</i> ]</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
@ -320,6 +320,27 @@ single-thread sync. This effectively sets the
<b>maxsyncaccounts</b> and all <b>maxconnections</b>
configuration file variables to 1.</td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td><td width="90%">
<b>-P</b> <i>profiledir</i></td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="21%"></td><td width="79%">
Sets <b>OfflineIMAP</b> into profile mode. The program will
create <b>profiledir</b> (it must not already exist). As it
runs, Python profiling information about each thread is
logged into profiledir. Please note: This option is present
for debugging and optimization only, and should NOT be used
unless you have a specific reason to do so. It will
significantly slow program performance, may reduce
reliability, and can generate huge amounts of data. You must
use the <b>-1</b> option when you use
<b>-P.</b></td></table>
<table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">

BIN
offlineimap/head/manual.pdf
View File

Binary file not shown.

612
offlineimap/head/manual.ps
View File

@ -1,11 +1,11 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.17.2
%%CreationDate: Sun Jul 21 20:54:02 2002
%%CreationDate: Mon Jul 22 15:46:51 2002
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.17 2
%%Pages: 6
%%Pages: 7
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
@ -210,111 +210,111 @@ BP
(\215ineIMAP \255 Po)-.25 E
(werful IMAP/Maildir synchronization and reader support)-.25 E F1
(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(of\215ineimap)108 124.8 Q F0
([)2.5 E F2<ad31>2.5 E F0 2.5(][)2.5 G F2<ad61>A/F3 10/Times-Italic@0 SF
(accountlist)2.5 E F0 2.5(][)2.5 G F2<ad63>A F3(con\214g\214le)2.5 E F0
(])2.5 E([)108 136.8 Q F2<ad64>2.5 E F0 2.5(][)2.5 G F2<ad6f>A F0 2.5
(][)2.5 G F2<ad75>A F3(interface)2.5 E F0(])2.5 E F2
(of\215ineimap \255h)108 160.8 Q F0(|)2.5 E F2(\255\255help)2.5 E F1
(DESCRIPTION)72 177.6 Q F2(Of\215ineIMAP)108 189.6 Q F0 .019
(is a tool to simplify your e-mail reading.)2.519 F -.4(Wi)5.019 G(th).4
E F2(Of\215ineIMAP)2.519 E(,)-.92 E F0 .018
([)2.5 E F2<ad31>2.5 E F0 2.5(][)2.5 G F2<ad50>A/F3 10/Times-Italic@0 SF
(pr)2.5 E(o\214ledir)-.45 E F0 2.5(][)2.5 G F2<ad61>A F3(accountlist)2.5
E F0 2.5(][)2.5 G F2<ad63>A F3(con\214g\214le)2.5 E F0 2.5(][)2.5 G F2
<ad64>A F0 2.5(][)2.5 G F2<ad6f>A F0 2.5(][)2.5 G F2<ad75>A F3
(interface)2.5 E F0(])2.5 E F2(of\215ineimap \255h)108 148.8 Q F0(|)2.5
E F2(\255\255help)2.5 E F1(DESCRIPTION)72 165.6 Q F2(Of\215ineIMAP)108
177.6 Q F0 .019(is a tool to simplify your e-mail reading.)2.519 F -.4
(Wi)5.019 G(th).4 E F2(Of\215ineIMAP)2.519 E(,)-.92 E F0 .018
(you can read the same mailbox)2.519 F 1.115(from multiple computers.)
108 201.6 R -1.1(Yo)6.115 G 3.615(ug)1.1 G 1.115(et a current cop)-3.615
108 189.6 R -1.1(Yo)6.115 G 3.615(ug)1.1 G 1.115(et a current cop)-3.615
F 3.616(yo)-.1 G 3.616(fy)-3.616 G 1.116(our messages on each computer)
-3.616 F 3.616(,a)-.4 G 1.116(nd changes you)-3.616 F(mak)108 213.6 Q
-3.616 F 3.616(,a)-.4 G 1.116(nd changes you)-3.616 F(mak)108 201.6 Q
2.915(eo)-.1 G .414(ne place will be visible on all other systems.)
-2.915 F -.15(Fo)5.414 G 2.914(ri).15 G .414
(nstance, you can delete a message on your home)-2.914 F(computer)108
225.6 Q 3.5(,a)-.4 G 1(nd it will appear deleted on your w)-3.5 F 1
213.6 Q 3.5(,a)-.4 G 1(nd it will appear deleted on your w)-3.5 F 1
(ork computer as well.)-.1 F F2(Of\215ineIMAP)6 E F0 1
(is also useful if you)3.5 F -.1(wa)108 237.6 S .827
(is also useful if you)3.5 F -.1(wa)108 225.6 S .827
(nt to use a mail reader that does not ha).1 F 1.127 -.15(ve I)-.2 H
.827(MAP support, has poor IMAP support, or does not pro).15 F(vide)-.15
E(disconnected operation.)108 249.6 Q F2(Of\215ineIMAP)108 266.4 Q F0
E(disconnected operation.)108 237.6 Q F2(Of\215ineIMAP)108 254.4 Q F0
(is)3.216 E F3 -1.15(FA)3.216 G(ST)1.15 E(;)-.65 E F0 .716
(it synchronizes my tw)3.216 F 3.216(oa)-.1 G .716(ccounts with o)-3.216
F -.15(ve)-.15 G 3.216(r5).15 G 3.216(0f)-3.216 G .717
(olders in 3 seconds.)-3.216 F .717(Other similar)5.717 F .26
(tools might tak)108 278.4 R 2.76(eo)-.1 G -.15(ve)-2.91 G 2.76(ram).15
(tools might tak)108 266.4 R 2.76(eo)-.1 G -.15(ve)-2.91 G 2.76(ram).15
G .26(inute, and achie)-2.76 F .56 -.15(ve a l)-.25 H .259
(ess-reliable result.).15 F .259(Some mail readers can tak)5.259 F 2.759
(eo)-.1 G -.15(ve)-2.909 G 2.759(r1).15 G 2.759(0m)-2.759 G(in-)-2.759 E
.157(utes to do the same thing, and some don')108 290.4 R 2.657(te)-.18
.157(utes to do the same thing, and some don')108 278.4 R 2.657(te)-.18
G -.15(ve)-2.907 G 2.657(ns).15 G .157(upport it at all.)-2.657 F(Unlik)
5.158 E 2.658(eo)-.1 G .158(ther mail tools,)-2.658 F F2(Of\215ineIMAP)
2.658 E F0(fea-)2.658 E .321(tures a multi-threaded synchronization alg\
orithm that can dramatically speed up performance in man)108 302.4 R
2.82(ys)-.15 G(itu-)-2.82 E(ations by synchronizing se)108 314.4 Q -.15
orithm that can dramatically speed up performance in man)108 290.4 R
2.82(ys)-.15 G(itu-)-2.82 E(ations by synchronizing se)108 302.4 Q -.15
(ve)-.25 G(ral dif).15 E(ferent things simultaneously)-.25 E(.)-.65 E F2
(Of\215ineIMAP)108 331.2 Q F0(is)3.065 E F3(FLEXIBLE;)3.065 E F0 .566
(Of\215ineIMAP)108 319.2 Q F0(is)3.065 E F3(FLEXIBLE;)3.065 E F0 .566
(you can customize which folders are synced via re)3.065 F .566(gular e)
-.15 F .566(xpressions, lists, or)-.15 F .734(Python e)108 343.2 R .734
-.15 F .566(xpressions, lists, or)-.15 F .734(Python e)108 331.2 R .734
(xpressions; a v)-.15 F .734(ersatile and comprehensi)-.15 F 1.034 -.15
(ve c)-.25 H .733(on\214guration \214le is used to control beha).15 F
.733(vior; tw)-.2 F 3.233(ou)-.1 G(ser)-3.233 E(interf)108 355.2 Q .535
.733(vior; tw)-.2 F 3.233(ou)-.1 G(ser)-3.233 E(interf)108 343.2 Q .535
(aces are b)-.1 F .535(uilt-in; \214ne-tuning of synchronization perfor\
mance is possible; internal or e)-.2 F .535(xternal automa-)-.15 F .441
(tion is supported; SSL and PREA)108 367.2 R .441
(tion is supported; SSL and PREA)108 355.2 R .441
(UTH tunnels are both supported; of)-.55 F .44
(\215ine \(or "unplugged"\) reading is sup-)-.25 F .543(ported; and eso\
teric IMAP features are supported to ensure compatibility with the wide\
st v)108 379.2 R .544(ariety of IMAP)-.25 F(serv)108 391.2 Q(ers.)-.15 E
F2(Of\215ineIMAP)108 408 Q F0(is)4.065 E F3(SAFE;)4.065 E F0 1.565
st v)108 367.2 R .544(ariety of IMAP)-.25 F(serv)108 379.2 Q(ers.)-.15 E
F2(Of\215ineIMAP)108 396 Q F0(is)4.065 E F3(SAFE;)4.065 E F0 1.565
(it uses an algorithm designed to pre)4.065 F -.15(ve)-.25 G 1.565
(nt mail loss at all costs.).15 F 1.564(Because of the)6.564 F .01
(design of this algorithm, e)108 420 R -.15(ve)-.25 G 2.51(np).15 G .01
(design of this algorithm, e)108 408 R -.15(ve)-.25 G 2.51(np).15 G .01
(rogramming errors should not result in loss of mail.)-2.51 F 2.511(Ia)
5.011 G 2.511(ms)-2.511 G 2.511(oc)-2.511 G .011(on\214dent in the)
-2.511 F .448(algorithm that I use my o)108 432 R .448
-2.511 F .448(algorithm that I use my o)108 420 R .448
(wn personal and w)-.25 F .448(ork accounts for testing of)-.1 F F2
(Of\215ineIMAP)2.948 E F0 .448(pre-release, de)2.948 F -.15(ve)-.25 G
(lop-).15 E(ment, and beta releases.)108 444 Q F2(METHOD OF OPERA)87
460.8 Q(TION)-.95 E(Of\215ineIMAP)108 472.8 Q F0 .07
(lop-).15 E(ment, and beta releases.)108 432 Q F2(METHOD OF OPERA)87
448.8 Q(TION)-.95 E(Of\215ineIMAP)108 460.8 Q F0 .07
(operates by maintaining a hierarch)2.57 F 2.57(yo)-.05 G 2.57(fm)-2.57
G .07(ail folders in Maildir format locally)-2.57 F 5.07(.Y)-.65 G .07
(our o)-6.17 F .07(wn mail)-.25 F .618
(reader will read mail from this tree, and need ne)108 484.8 R -.15(ve)
(reader will read mail from this tree, and need ne)108 472.8 R -.15(ve)
-.25 G 3.118(rk).15 G(no)-3.118 E 3.118(wt)-.25 G .617
(hat the mail comes from IMAP)-3.118 F(.)-1.11 E F2(Of\215ineIMAP)5.617
E F0 .849(will detect changes to the mail folders on your IMAP serv)108
496.8 R .849(er and your o)-.15 F .849(wn computer and bi-directionally)
-.25 F(synchronize them, cop)108 508.8 Q
484.8 R .849(er and your o)-.15 F .849(wn computer and bi-directionally)
-.25 F(synchronize them, cop)108 496.8 Q
(ying, marking, and deleting messages as necessary)-.1 E(.)-.65 E F1
(INST)72 525.6 Q(ALLA)-.986 E(TION)-1.04 E F0 .491
(INST)72 513.6 Q(ALLA)-.986 E(TION)-1.04 E F0 .491
(If you are reading this document via the "man" command, it is lik)108
537.6 R .49(ely that you ha)-.1 F .79 -.15(ve n)-.2 H 2.99(oi).15 G .49
525.6 R .49(ely that you ha)-.1 F .79 -.15(ve n)-.2 H 2.99(oi).15 G .49
(nstallation tasks to)-2.99 F .043
(perform; your system administrator has already installed it.)108 549.6
(perform; your system administrator has already installed it.)108 537.6
R .044(If you need to install it yourself, you ha)5.043 F .344 -.15
(ve t)-.2 H(hree).15 E .39(options: a system-wide installation with Deb\
ian, system-wide installation with other systems, and a single-)108
561.6 R 12.823(user installation.)108 573.6 R -1.1(Yo)17.823 G 15.323
549.6 R 12.823(user installation.)108 561.6 R -1.1(Yo)17.823 G 15.323
(uc)1.1 G 12.823(an do)-15.323 F 12.823(wnload the latest v)-.25 F
12.823(ersion of Of)-.15 F 12.823(\215ineIMAP from)-.25 F
(http://quux.or)108 585.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap/.)-.25 E F2(PREREQ)87 602.4 Q(UISITES)-.1 E F0
(In order to use Of)108 614.4 Q(\215ineIMAP)-.25 E 2.5(,y)-1.11 G
(http://quux.or)108 573.6 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap/.)-.25 E F2(PREREQ)87 590.4 Q(UISITES)-.1 E F0
(In order to use Of)108 602.4 Q(\215ineIMAP)-.25 E 2.5(,y)-1.11 G
(ou need to ha)-2.5 E .3 -.15(ve t)-.2 H(hese conditions satis\214ed:)
.15 E 32.5<8359>108 631.2 S .197(our mail serv)-33.6 F .197
.15 E 32.5<8359>108 619.2 S .197(our mail serv)-33.6 F .197
(er must support IMAP)-.15 F 5.197(.M)-1.11 G .197
(ost Internet Service Pro)-5.197 F .197(viders and corporate netw)-.15 F
.196(orks do,)-.1 F(and most operating systems ha)144 643.2 Q .3 -.15
.196(orks do,)-.1 F(and most operating systems ha)144 631.2 Q .3 -.15
(ve a)-.2 H 2.5(nI).15 G(MAP implementation readily a)-2.5 E -.25(va)-.2
G(ilable.).25 E 32.5<8359>108 660 S .085(ou must ha)-33.6 F .385 -.15
G(ilable.).25 E 32.5<8359>108 648 S .085(ou must ha)-33.6 F .385 -.15
(ve P)-.2 H .085(ython v).15 F .085(ersion 2.2.1 or abo)-.15 F .385 -.15
(ve i)-.15 H 2.585(nstalled. If).15 F .086
(you are running on Debian GNU/Linux,)2.585 F .813
(this requirement will automatically be tak)144 672 R .813
(this requirement will automatically be tak)144 660 R .813
(en care of for you.)-.1 F .812(If you do not ha)5.812 F 1.112 -.15
(ve P)-.2 H .812(ython already).15 F(,)-.65 E 3.88
(check with your system administrator or operating system v)144 684 R
(check with your system administrator or operating system v)144 672 R
3.88(endor; or)-.15 F 6.38(,d)-.4 G -.25(ow)-6.38 G 3.88(nload it from)
.25 F(http://www)144 696 Q(.p)-.65 E(ython.or)-.1 E 3.378(g/. If)-.18 F
.25 F(http://www)144 684 Q(.p)-.65 E(ython.or)-.1 E 3.378(g/. If)-.18 F
.878(you intend to use the Tk interf)3.378 F .877(ace, you must ha)-.1 F
1.177 -.15(ve T)-.2 H .877(kiner \(p).15 F(ython-tk\))-.1 E 2.859
(installed. If)144 708 R .359(you intend to use the SSL interf)2.859 F
(installed. If)144 696 R .359(you intend to use the SSL interf)2.859 F
.359(ace, your Python must ha)-.1 F .66 -.15(ve b)-.2 H .36(een b).15 F
.36(uilt with SSL sup-)-.2 F(port.)144 720 Q(John Goerzen)72 768 Q
.36(uilt with SSL sup-)-.2 F(port.)144 708 Q(John Goerzen)72 768 Q
(July 12, 2002)151.655 E(1)201.915 E EP
%%Page: 2 2
%%BeginPageSetup
@ -381,395 +381,417 @@ R(Ne)5.061 E -.15(ve)-.25 G .061(rtheless, there are a fe).15 F 2.561
ithreading operations and use solely a single-thread sync.)25.3 F .281
(This ef)5.281 F(fecti)-.25 E -.15(ve)-.25 G .281(ly sets the).15 F F1
(maxsyncaccounts)144 525.6 Q F0(and all)2.5 E F1(maxconnections)2.5 E F0
(con\214guration \214le v)2.5 E(ariables to 1.)-.25 E F1<ad61>108 542.4
Q F3(accountlist)2.5 E F0(Ov)144 554.4 Q .84(errides the)-.15 F F1
(accounts)3.34 E F0 .84(section in the con\214g \214le.)3.34 F .84
(con\214guration \214le v)2.5 E(ariables to 1.)-.25 E F1<ad50>108 542.4
Q F3(pr)2.5 E(o\214ledir)-.45 E F0(Sets)144 554.4 Q F1(Of\215ineIMAP)
4.196 E F0 1.696(into pro\214le mode.)4.196 F 1.695
(The program will create)6.696 F F1(pr)4.195 E(o\214ledir)-.18 E F0
1.695(\(it must not already)4.195 F -.15(ex)144 566.4 S 2.88(ist\). As)
.15 F .381(it runs, Python pro\214ling information about each thread is\
logged into pro\214ledir)2.88 F 5.381(.P)-.55 G(lease)-5.381 E .485
(note: This option is present for deb)144 578.4 R .485
(ugging and optimization only)-.2 F 2.985(,a)-.65 G .484(nd should NO)
-2.985 F 2.984(Tb)-.4 G 2.984(eu)-2.984 G .484(sed unless)-2.984 F .778
(you ha)144 590.4 R 1.078 -.15(ve a s)-.2 H .778
(peci\214c reason to do so.).15 F .778(It will signi\214cantly slo)5.778
F 3.278(wp)-.25 G .778(rogram performance, may reduce)-3.278 F
(reliability)144 602.4 Q 2.5(,a)-.65 G
(nd can generate huge amounts of data.)-2.5 E -1.1(Yo)5 G 2.5(um)1.1 G
(ust use the)-2.5 E F1<ad31>2.5 E F0(option when you use)2.5 E F1(-P)2.5
E(.)-1.1 E<ad61>108 631.2 Q F3(accountlist)2.5 E F0(Ov)144 643.2 Q .84
(errides the)-.15 F F1(accounts)3.34 E F0 .84
(section in the con\214g \214le.)3.34 F .84
(Lets you specify a particular account or set of)5.84 F 1.647
(accounts to sync without ha)144 566.4 R 1.647
(accounts to sync without ha)144 655.2 R 1.647
(ving to edit the con\214g \214le.)-.2 F -1.1(Yo)6.648 G 4.148(um)1.1 G
1.648(ight use this to e)-4.148 F 1.648(xclude certain)-.15 F
(accounts, or to sync some accounts that you normally prefer not to.)144
578.4 Q F1<ad63>108 595.2 Q F3(con\214g\214le)2.5 E F0
(Speci\214es a con\214guration \214le to use in lieu of the def)144
607.2 Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F1
<ad64>108 624 Q F0 1.139(Enables IMAP protocol stream and parsing deb)
24.74 F 3.639(ugging. This)-.2 F 1.138
(is useful if you are trying to track)3.639 F(do)144 636 Q .081
667.2 Q F1<ad63>108 684 Q F3(con\214g\214le)2.5 E F0
(Speci\214es a con\214guration \214le to use in lieu of the def)144 696
Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F1<ad64>108
712.8 Q F0 1.139(Enables IMAP protocol stream and parsing deb)24.74 F
3.639(ugging. This)-.2 F 1.138(is useful if you are trying to track)
3.639 F(do)144 724.8 Q .081
(wn a malfunction or \214gure out what is going on under the hood.)-.25
F 2.582(Is)5.082 G .082(uggest that you use this with)-2.582 F F1<ad31>
144 648 Q F0 .336(in order to mak)2.836 F 2.836(et)-.1 G .335
(he results more sensible.)-2.836 F .335
(Note that this output will contain full IMAP proto-)5.335 F 1.7
(col in plain te)144 660 R 1.7(xt, including passw)-.15 F 1.7
(ords, so tak)-.1 F 4.2(ec)-.1 G 1.7(are to remo)-4.2 F 2 -.15(ve t)-.15
H 1.7(hat from the deb).15 F 1.7(ugging output)-.2 F
(before sending it to an)144 672 Q(yone else.)-.15 E F1<ad6f>108 688.8 Q
F0(Run only once, ignoring an)25.3 E 2.5(ya)-.15 G
(utorefresh setting in the con\214g \214le.)-2.5 E F1
(\255h, \255\255help)108 705.6 Q F0(Sho)144 717.6 Q 2.5(ws)-.25 G
(ummary of options.)-2.5 E(John Goerzen)72 768 Q(July 12, 2002)151.655 E
(2)201.915 E EP
F 2.582(Is)5.082 G .082(uggest that you use this with)-2.582 F
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(2)201.915 E EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF<ad75>108 84 Q/F2 10/Times-Italic@0 SF(interface)2.5 E F0 1.133
(Speci\214es an alternati)144 96 R 1.433 -.15(ve u)-.25 H 1.133
(ser interf).15 F 1.133(ace module to use.)-.1 F 1.133(This o)6.133 F
-.15(ve)-.15 G 1.133(rrides the def).15 F 1.132(ault speci\214ed in the)
-.1 F .28(con\214guration \214le.)144 108 R .28(The UI speci\214ed with)
5.28 F F1(-u)2.78 E F0 .281(will be forced to be used, e)2.78 F -.15(ve)
-.25 G 2.781(ni).15 G 2.781(fi)-2.781 G(ts)-2.781 E F1(isuable\(\))2.781
E F0(method)2.781 E(states that it cannot be.)144 120 Q
(Use this option with care.)5 E 1.485(The pre-de\214ned options are)144
136.8 R F1(Tk.TKUI)3.985 E F0 1.485(\(a graphical interf)3.985 F(ace\),)
-.1 E F1(TTY)3.984 E(.TTYUI)-.92 E F0 1.484(\(a te)3.984 F 1.484
(xt-mode inter)-.15 F(-)-.2 E -.1(fa)144 148.8 S(ce\),).1 E F1
(Noninteracti)5.044 E -.1(ve)-.1 G(.Basic).1 E F0 2.544
(\(a non-interacti)5.044 F 2.844 -.15(ve m)-.25 H 2.545
SF<ad31>144 84 Q F0 .336(in order to mak)2.836 F 2.836(et)-.1 G .335
(he results more sensible.)-2.836 F .335
(Note that this output will contain full IMAP proto-)5.335 F 1.7
(col in plain te)144 96 R 1.7(xt, including passw)-.15 F 1.7
(ords, so tak)-.1 F 4.2(ec)-.1 G 1.7(are to remo)-4.2 F 2 -.15(ve t)-.15
H 1.7(hat from the deb).15 F 1.7(ugging output)-.2 F
(before sending it to an)144 108 Q(yone else.)-.15 E F1<ad6f>108 124.8 Q
F0(Run only once, ignoring an)25.3 E 2.5(ya)-.15 G
(utorefresh setting in the con\214g \214le.)-2.5 E F1
(\255h, \255\255help)108 141.6 Q F0(Sho)144 153.6 Q 2.5(ws)-.25 G
(ummary of options.)-2.5 E F1<ad75>108 170.4 Q/F2 10/Times-Italic@0 SF
(interface)2.5 E F0 1.133(Speci\214es an alternati)144 182.4 R 1.433
-.15(ve u)-.25 H 1.133(ser interf).15 F 1.133(ace module to use.)-.1 F
1.133(This o)6.133 F -.15(ve)-.15 G 1.133(rrides the def).15 F 1.132
(ault speci\214ed in the)-.1 F .28(con\214guration \214le.)144 194.4 R
.28(The UI speci\214ed with)5.28 F F1(-u)2.78 E F0 .281
(will be forced to be used, e)2.78 F -.15(ve)-.25 G 2.781(ni).15 G 2.781
(fi)-2.781 G(ts)-2.781 E F1(isuable\(\))2.781 E F0(method)2.781 E
(states that it cannot be.)144 206.4 Q(Use this option with care.)5 E
1.485(The pre-de\214ned options are)144 223.2 R F1(Tk.TKUI)3.985 E F0
1.485(\(a graphical interf)3.985 F(ace\),)-.1 E F1(TTY)3.984 E(.TTYUI)
-.92 E F0 1.484(\(a te)3.984 F 1.484(xt-mode inter)-.15 F(-)-.2 E -.1
(fa)144 235.2 S(ce\),).1 E F1(Noninteracti)5.044 E -.1(ve)-.1 G(.Basic)
.1 E F0 2.544(\(a non-interacti)5.044 F 2.844 -.15(ve m)-.25 H 2.545
(ode suitable for cronning\), and).15 F F1(Noninterac-)5.045 E(ti)144
160.8 Q -.1(ve)-.1 G(.Quiet).1 E F0(\(a mode that generates no output e)
247.2 Q -.1(ve)-.1 G(.Quiet).1 E F0(\(a mode that generates no output e)
2.5 E(xcept for errors\).)-.15 E/F3 10.95/Times-Bold@0 SF(EXAMPLES)72
177.6 Q F0(Here is an e)108 189.6 Q
264 Q F0(Here is an e)108 276 Q
(xample con\214guration for a particularly comple)-.15 E 2.5(xs)-.15 G
(ituation; more e)-2.5 E(xamples will be added later)-.15 E(.)-.55 E F1
(MUL)87 206.4 Q(TIPLE A)-.92 E(CCOUNTS WITH MUTT)-.55 E F0 .514(This e)
108 218.4 R .514(xample sho)-.15 F .514(ws you ho)-.25 F 3.014(wt)-.25 G
(MUL)87 292.8 Q(TIPLE A)-.92 E(CCOUNTS WITH MUTT)-.55 E F0 .514(This e)
108 304.8 R .514(xample sho)-.15 F .514(ws you ho)-.25 F 3.014(wt)-.25 G
3.014(os)-3.014 G .514(et up)-3.014 F F1(Of\215ineIMAP)3.014 E F0 .513
(to synchronize multiple accounts with the mutt mail)3.014 F(reader)108
230.4 Q(.)-.55 E(Start by creating a directory to hold your folders:)108
247.2 Q F1(mkdir ~/Mail)108 259.2 Q F0(In your)108 276 Q F2(~/.of)2.5 E
(\215ineimapr)-.18 E(c,)-.37 E F0(specify this:)2.5 E F1(accounts = P)
108 288 Q(ersonal, W)-.2 E(ork)-.75 E F0(Mak)108 304.8 Q 2.82(es)-.1 G
316.8 Q(.)-.55 E(Start by creating a directory to hold your folders:)108
333.6 Q F1(mkdir ~/Mail)108 345.6 Q F0(In your)108 362.4 Q F2(~/.of)2.5
E(\215ineimapr)-.18 E(c,)-.37 E F0(specify this:)2.5 E F1(accounts = P)
108 374.4 Q(ersonal, W)-.2 E(ork)-.75 E F0(Mak)108 391.2 Q 2.82(es)-.1 G
.32(ure that you ha)-2.82 F .62 -.15(ve b)-.2 H .32(oth a).15 F F1([P)
2.821 E(ersonal])-.2 E F0 .321(and a)2.821 F F1([W)2.821 E(ork])-.75 E
F0 .321(section, with dif)2.821 F .321(ferent localfolder pathnames and)
-.25 F(enable)108 316.8 Q F1([mbnames].)2.5 E F0
(In each account section, do something lik)108 333.6 Q 2.5(et)-.1 G
(his:)-2.5 E F1(localf)108 345.6 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2
E F0(Add these lines to your)108 362.4 Q F2(~/.muttr)2.5 E(c:)-.37 E F1
(sour)108 374.4 Q(ce ~/path-to-mbnames-muttr)-.18 E(c-mailboxes)-.18 E
-.25(fo)108 386.4 S(lder).25 E(-hook P)-.37 E(ersonal set fr)-.2 E
(om="y)-.18 E(our)-.25 E(email@personal.com")-.18 E -.25(fo)108 398.4 S
-.25 F(enable)108 403.2 Q F1([mbnames].)2.5 E F0
(In each account section, do something lik)108 420 Q 2.5(et)-.1 G(his:)
-2.5 E F1(localf)108 432 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2 E F0
(Add these lines to your)108 448.8 Q F2(~/.muttr)2.5 E(c:)-.37 E F1
(sour)108 460.8 Q(ce ~/path-to-mbnames-muttr)-.18 E(c-mailboxes)-.18 E
-.25(fo)108 472.8 S(lder).25 E(-hook P)-.37 E(ersonal set fr)-.2 E
(om="y)-.18 E(our)-.25 E(email@personal.com")-.18 E -.25(fo)108 484.8 S
(lder).25 E(-hook W)-.37 E(ork set fr)-.75 E(om="y)-.18 E(our)-.25 E
(email@w)-.18 E(ork.com")-.1 E(set mbox_type=Maildir)108 410.4 Q(set f)
108 422.4 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 434.4 Q
(ersonal/INBO)-.2 E(X)-.4 E F0(That')108 451.2 Q 2.5(si)-.55 G(t!)-2.5 E
F1(UW)87 468 Q(-IMAPD AND REFERENCES)-.37 E F0 .494
(Some users with a UW)108 480 R .493(-IMAPD serv)-.65 F .493
(email@w)-.18 E(ork.com")-.1 E(set mbox_type=Maildir)108 496.8 Q(set f)
108 508.8 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 520.8 Q
(ersonal/INBO)-.2 E(X)-.4 E F0(That')108 537.6 Q 2.5(si)-.55 G(t!)-2.5 E
F1(UW)87 554.4 Q(-IMAPD AND REFERENCES)-.37 E F0 .494
(Some users with a UW)108 566.4 R .493(-IMAPD serv)-.65 F .493
(er need to use)-.15 F F1(Of\215ineIMAP')2.993 E(s)-.37 E F0 .493
("reference" feature to get at their mail-)2.993 F(box)108 492 Q .46(es\
, specifying a reference of "~/Mail" or "#mh/" depending on the con\214\
guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)-2.96 E
.465(tion from docwhat@gerf.or)108 504 R 2.965(gs)-.18 G(ho)-2.965 E
.465(ws using a reference of Mail, a nametrans that strips the leading \
Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\214lter th\
at limits the folders synced to just three.)108 516 Q F1([Gerf])108
532.8 Q(localf)108 544.8 Q(olders = ~/Mail)-.25 E -.18(re)108 556.8 S
(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 568.8 Q(es)-.1 E
-.18(re)108 580.8 S(moteuser = docwhat).18 E -.18(re)108 592.8 S(fer).18
E(ence = Mail)-.18 E 2.5(#T)108 604.8 S(rims off the pr)-3.24 E
(eceeding Mail on all the f)-.18 E(older names.)-.25 E
(nametrans = lambda f)108 616.8 Q(older)-.25 E(name: \\)-.15 E -.18(re)
138 628.8 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15
E 2.5(#Y)108 640.8 S(eah, y)-3.61 E(ou ha)-.25 E .2 -.1(ve t)-.25 H 2.5
("reference" feature to get at their mail-)2.993 F(box)108 578.4 Q .46(\
es, specifying a reference of "~/Mail" or "#mh/" depending on the con\
\214guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)
-2.96 E .465(tion from docwhat@gerf.or)108 590.4 R 2.965(gs)-.18 G(ho)
-2.965 E .465(ws using a reference of Mail, a nametrans that strips the\
leading Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\
\214lter that limits the folders synced to just three.)108 602.4 Q F1
([Gerf])108 619.2 Q(localf)108 631.2 Q(olders = ~/Mail)-.25 E -.18(re)
108 643.2 S(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 655.2 Q
(es)-.1 E -.18(re)108 667.2 S(moteuser = docwhat).18 E -.18(re)108 679.2
S(fer).18 E(ence = Mail)-.18 E 2.5(#T)108 691.2 S(rims off the pr)-3.24
E(eceeding Mail on all the f)-.18 E(older names.)-.25 E
(nametrans = lambda f)108 703.2 Q(older)-.25 E(name: \\)-.15 E -.18(re)
138 715.2 S(.sub\('^Mail/', ').18 E(', f)-.63 E(older)-.25 E(name\))-.15
E 2.5(#Y)108 727.2 S(eah, y)-3.61 E(ou ha)-.25 E .2 -.1(ve t)-.25 H 2.5
(om).1 G(ention the Mail dir)-2.5 E 2.5(,e)-.92 G -.1(ve)-2.65 G 2.5(nt)
.1 G(hough it)-2.5 E 2.5(#w)108 652.8 S(ould seem intuiti)-2.6 E .2 -.1
(ve t)-.1 H(hat r).1 E(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E
-.25(fo)108 664.8 S(lder\214lter = lambda f).25 E(older)-.25 E(name: f)
-.15 E(older)-.25 E(name in [)-.15 E('Mail/INBO)125.5 676.8 Q(X',)-.4 E
('Mail/list/zaurus-general',)125.5 688.8 Q('Mail/list/zaurus-de)125.5
700.8 Q(v',)-.15 E(])125.5 712.8 Q(maxconnections = 1)108 724.8 Q F0
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(3)201.915 E EP
.1 G(hough it)-2.5 E F0(John Goerzen)72 768 Q(July 12, 2002)151.655 E(3)
201.915 E EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF(holdconnectionopen = no)108 84 Q/F2 10.95/Times-Bold@0 SF(ERR)72
100.8 Q(ORS)-.329 E F0(If you get one of some frequently-encountered or\
confusing errors, please check this section.)108 112.8 Q F1(UID v)87
129.6 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 E F0
1.637(IMAP serv)108 141.6 R 1.637
SF 2.5(#w)108 84 S(ould seem intuiti)-2.6 E .2 -.1(ve t)-.1 H(hat r).1 E
(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E -.25(fo)108 96 S
(lder\214lter = lambda f).25 E(older)-.25 E(name: f)-.15 E(older)-.25 E
(name in [)-.15 E('Mail/INBO)125.5 108 Q(X',)-.4 E
('Mail/list/zaurus-general',)125.5 120 Q('Mail/list/zaurus-de)125.5 132
Q(v',)-.15 E(])125.5 144 Q(maxconnections = 1)108 156 Q
(holdconnectionopen = no)108 168 Q/F2 10.95/Times-Bold@0 SF(ERR)72 184.8
Q(ORS)-.329 E F0(If you get one of some frequently-encountered or confu\
sing errors, please check this section.)108 196.8 Q F1(UID v)87 213.6 Q
(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 E F0 1.637
(IMAP serv)108 225.6 R 1.637
(ers use a unique ID \(UID\) to refer to a speci\214c message.)-.15 F
1.638(This number is guaranteed to be)6.637 F 1.11
(unique to a particular message FOREVER.)108 153.6 R 1.109
(unique to a particular message FOREVER.)108 237.6 R 1.109
(No other message in the same folder will e)6.11 F -.15(ve)-.25 G 3.609
(rg).15 G 1.109(et the same)-3.609 F 2.873(UID. UIDs)108 165.6 R .373
(rg).15 G 1.109(et the same)-3.609 F 2.873(UID. UIDs)108 249.6 R .373
(are an inte)2.873 F .373(gral part of Of)-.15 F(\215ineIMAP')-.25 E
2.873(ss)-.55 G .373(ynchronization scheme; the)-2.873 F 2.873(ya)-.15 G
.373(re used to match up mes-)-2.873 F
(sages on your computer to messages on the serv)108 177.6 Q(er)-.15 E(.)
-.55 E .108(Sometimes, the UIDs on the serv)108 194.4 R .108
(sages on your computer to messages on the serv)108 261.6 Q(er)-.15 E(.)
-.55 E .108(Sometimes, the UIDs on the serv)108 278.4 R .108
(er might get reset.)-.15 F .108
(Usually this will happen if you delete and then recreate)5.108 F 3.742
(af)108 206.4 S(older)-3.742 E 6.242(.W)-.55 G 1.242
(af)108 290.4 S(older)-3.742 E 6.242(.W)-.55 G 1.242
(hen you create a folder)-6.242 F 3.742(,t)-.4 G 1.242(he serv)-3.742 F
1.242(er will often start the UID back from 1.)-.15 F(But)6.243 E F1
(Of\215ineIMAP)3.743 E F0 .303(might still ha)108 218.4 R .603 -.15
(Of\215ineIMAP)3.743 E F0 .303(might still ha)108 302.4 R .603 -.15
(ve t)-.2 H .303(he UIDs from the pre).15 F .302
(vious folder by the same name stored.)-.25 F F1(Of\215ineIMAP)5.302 E
F0 .302(will detect this)2.802 F(condition and skip the folder)108 230.4
F0 .302(will detect this)2.802 F(condition and skip the folder)108 314.4
Q 5(.T)-.55 G(his is GOOD, because it pre)-5 E -.15(ve)-.25 G
(nts data loss.).15 E -1.1(Yo)108 247.2 S 2.826(uc)1.1 G .326
(nts data loss.).15 E -1.1(Yo)108 331.2 S 2.826(uc)1.1 G .326
(an \214x it by remo)-2.826 F .327
(ving your local folder and cache data.)-.15 F -.15(Fo)5.327 G 2.827(ri)
.15 G .327(nstance, if your folders are under)-2.827 F/F3 10
/Times-Italic@0 SF(~/F)2.827 E(old-)-1.05 E(er)108 259.2 Q(s)-.1 E F0
/Times-Italic@0 SF(~/F)2.827 E(old-)-1.05 E(er)108 343.2 Q(s)-.1 E F0
(and the folder with the problem is INBO)2.5 E(X, you')-.4 E 2.5(dt)-.5
G(ype this:)-2.5 E F1(rm -r ~/F)108 276 Q(olders/INBO)-.25 E(X)-.4 E
(rm ~/.of\215ineimap/AccountName/INBO)108 288 Q(X)-.4 E F0
G(ype this:)-2.5 E F1(rm -r ~/F)108 360 Q(olders/INBO)-.25 E(X)-.4 E
(rm ~/.of\215ineimap/AccountName/INBO)108 372 Q(X)-.4 E F0
(\(replacing AccountName with the account name as speci\214ed in)108
304.8 Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 321.6 Q
388.8 Q F3(~/.of)2.5 E(\215ineimapr)-.18 E(c\))-.37 E F0(Ne)108 405.6 Q
.802(xt time you run)-.15 F F1(Of\215ineIMAP)3.302 E(,)-.92 E F0 .802
(it will re-do)3.302 F .802(wnload the folder with the ne)-.25 F 3.302
(wU)-.25 G 3.301(IDs. Note)-3.302 F .801(that the proce-)3.301 F
(dure speci\214ed abo)108 333.6 Q .3 -.15(ve w)-.15 H(ill lose an).15 E
(dure speci\214ed abo)108 417.6 Q .3 -.15(ve w)-.15 H(ill lose an).15 E
2.5(yl)-.15 G(ocal changes made to the folder)-2.5 E(.)-.55 E .522
(Some IMAP serv)108 350.4 R .522(ers are brok)-.15 F .522
(Some IMAP serv)108 434.4 R .522(ers are brok)-.15 F .522
(en and do not support UIDs properly)-.1 F 5.522(.I)-.65 G 3.022(fy)
-5.522 G .522(ou continue to get this error for all)-3.022 F .067
(your folders e)108 362.4 R -.15(ve)-.25 G 2.566(na).15 G .066
(your folders e)108 446.4 R -.15(ve)-.25 G 2.566(na).15 G .066
(fter performing the abo)-2.566 F .366 -.15(ve p)-.15 H .066
(rocedure, it is lik).15 F .066(ely that your IMAP serv)-.1 F .066(er f)
-.15 F .066(alls into this cat-)-.1 F -.15(eg)108 374.4 S(ory).15 E(.)
-.15 F .066(alls into this cat-)-.1 F -.15(eg)108 458.4 S(ory).15 E(.)
-.65 E F1(Of\215ineIMAP)5.983 E F0 .984(is incompatible with such serv)
3.483 F 3.484(ers. Using)-.15 F F1(Of\215ineIMAP)3.484 E F0 .984
(with them will not destro)3.484 F(y)-.1 E(an)108 386.4 Q 2.77(ym)-.15 G
(with them will not destro)3.484 F(y)-.1 E(an)108 470.4 Q 2.77(ym)-.15 G
.27(ail, b)-2.77 F .27
(ut at the same time, it will not actually synchronize it either)-.2 F
5.269(.\()-.55 G(Of)-5.269 E .269(\215ineIMAP will detect this con-)-.25
F(dition and abort prior to synchronization\))108 398.4 Q F2 -.438(OT)72
427.2 S(HER FREQ).438 E(UENTL)-.11 E 2.738(YA)-1.007 G(SKED Q)-2.738 E
(UESTIONS)-.11 E F0 .683(There are some other F)108 439.2 R -.55(AQ)-.74
F(dition and abort prior to synchronization\))108 482.4 Q F2 -.438(OT)72
511.2 S(HER FREQ).438 E(UENTL)-.11 E 2.738(YA)-1.007 G(SKED Q)-2.738 E
(UESTIONS)-.11 E F0 .683(There are some other F)108 523.2 R -.55(AQ)-.74
G 3.184(st).55 G .684
(hat might not \214t into another section of this document, and the)
-3.184 F 3.184(ya)-.15 G .684(re enumer)-3.184 F(-)-.2 E(ated here.)108
451.2 Q F1(What platf)108 468 Q(orms does Of\215ineIMAP run on?)-.25 E
535.2 Q F1(What platf)108 552 Q(orms does Of\215ineIMAP run on?)-.25 E
F0(It should run on most platforms supported by Python, which are quite\
a fe)144 480 Q -.65(w.)-.25 G F1 .689
(I'm using Mutt. Other IMAP sync pr)108 496.8 R .689(ograms r)-.18 F
a fe)144 564 Q -.65(w.)-.25 G F1 .689
(I'm using Mutt. Other IMAP sync pr)108 580.8 R .689(ograms r)-.18 F
(equir)-.18 E 3.189(em)-.18 G 3.189(et)-3.189 G 3.189(ou)-3.189 G .689
(se set maildir_trash=y)-3.189 F .688(es . Do I need to)-.1 F
(do that with Of\215ineIMAP?)108 508.8 Q F0(No.)144 520.8 Q F1
(do that with Of\215ineIMAP?)108 592.8 Q F0(No.)144 604.8 Q F1
(Of\215ineIMAP)7.27 E F0 2.27
(is smart enough to \214gure out message deletion without this e)4.77 F
2.27(xtra crutch.)-.15 F -1.1(Yo)144 532.8 S(u')1.1 E
2.27(xtra crutch.)-.15 F -1.1(Yo)144 616.8 S(u')1.1 E
(ll get the best results if you don')-.1 E 2.5(tu)-.18 G
(se this setting, in f)-2.5 E(act.)-.1 E F1(Ho)108 549.6 Q 2.5(wd)-.1 G
(se this setting, in f)-2.5 E(act.)-.1 E F1(Ho)108 633.6 Q 2.5(wd)-.1 G
2.5(oIs)-2.5 G(pecify the names of my f)-2.5 E(olders?)-.25 E F0 -1.1
(Yo)144 561.6 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F
(Yo)144 645.6 S 3.55(ud)1.1 G 3.55(on)-3.55 G 1.05(ot need to.)-3.55 F
F1(Of\215ineIMAP)6.05 E F0 1.05
(is smart enough to automatically \214gure out what folders are)3.55 F
.679(present on the IMAP serv)144 573.6 R .679(er and synchronize them.)
.679(present on the IMAP serv)144 657.6 R .679(er and synchronize them.)
-.15 F -1.1(Yo)5.679 G 3.178(uc)1.1 G .678(an use the)-3.178 F F1 -.25
(fo)3.178 G(lder\214lter).25 E F0(and)3.178 E F1 -.25(fo)3.178 G
(ldertrans).25 E F0(con\214guration \214le options to request certain f\
olders and rename them as the)144 585.6 Q 2.5(yc)-.15 G
(ome in if you lik)-2.5 E(e.)-.1 E F1(Ho)108 602.4 Q 2.5(wc)-.1 G
olders and rename them as the)144 669.6 Q 2.5(yc)-.15 G
(ome in if you lik)-2.5 E(e.)-.1 E F1(Ho)108 686.4 Q 2.5(wc)-.1 G
(an I pr)-2.5 E -2.3 -.15(ev e)-.18 H(nt certain f).15 E(olders fr)-.25
E(om being synced?)-.18 E F0(Use the)144 614.4 Q F1 -.25(fo)2.5 G
(lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E F1
(Ho)108 631.2 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
(Of\215ineIMAP)144 643.2 Q F0 .503(does not currently pro)3.003 F .504
(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.004(wf)
-.25 G .504(older on the IMAP)-3.004 F(serv)144 655.2 Q(er)-.15 E 2.5
(,i)-.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)
-.65 E F1(Ar)108 672 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G
(ny other war)-2.5 E(nings that I should be awar)-.15 E 2.5(eo)-.18 G
(f?)-2.5 E F0 -1(Ye)144 684 S(s; see the NO)1 E(TES section belo)-.4 E
-.65(w.)-.25 G F1(What is the mailbox name r)108 700.8 Q
(ecorder \(mbnames\) f)-.18 E(or?)-.25 E F0 1.019(The Mutt mail reader \
is not capable of automatically determining the names of your mailbox)
144 712.8 R(es.)-.15 E(Of)144 724.8 Q .265
(\215ineIMAP can help it \(or man)-.25 F 2.765(yo)-.15 G .265
(ther\) programs out be writing these names out in a format you)-2.765 F
E(om being synced?)-.18 E F0(Use the)144 698.4 Q F1 -.25(fo)2.5 G
(lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E(specify)144 84 Q 5
(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
(\215ineimap.conf \214le for details.)-.25 E/F1 10/Times-Bold@0 SF
(Can I synchr)108 100.8 Q(onize multiple accounts with Of\215ineIMAP?)
-.18 E F0 3.345(Sure. Just)144 112.8 R .845(name them all in the accoun\
ts line in the general section of the con\214g \214le, and add a)3.345 F
(per)144 124.8 Q(-account section for each one.)-.2 E F1
(Does Of\215ineIMAP support POP?)108 141.6 Q F0 4.076(No. POP)144 153.6
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF(Ho)108 84 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
(Of\215ineIMAP)144 96 Q F0 .503(does not currently pro)3.003 F .504
(vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.004(wf)
-.25 G .504(older on the IMAP)-3.004 F(serv)144 108 Q(er)-.15 E 2.5(,i)
-.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)-.65 E
F1(Ar)108 124.8 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G(ny other war)
-2.5 E(nings that I should be awar)-.15 E 2.5(eo)-.18 G(f?)-2.5 E F0 -1
(Ye)144 136.8 S(s; see the NO)1 E(TES section belo)-.4 E -.65(w.)-.25 G
F1(What is the mailbox name r)108 153.6 Q(ecorder \(mbnames\) f)-.18 E
(or?)-.25 E F0 1.019(The Mutt mail reader is not capable of automatical\
ly determining the names of your mailbox)144 165.6 R(es.)-.15 E(Of)144
177.6 Q .265(\215ineIMAP can help it \(or man)-.25 F 2.765(yo)-.15 G
.265(ther\) programs out be writing these names out in a format you)
-2.765 F(specify)144 189.6 Q 5(.S)-.65 G(ee the e)-5 E(xample of)-.15 E
(\215ineimap.conf \214le for details.)-.25 E F1(Can I synchr)108 206.4 Q
(onize multiple accounts with Of\215ineIMAP?)-.18 E F0 3.345(Sure. Just)
144 218.4 R .845(name them all in the accounts line in the general sect\
ion of the con\214g \214le, and add a)3.345 F(per)144 230.4 Q
(-account section for each one.)-.2 E F1
(Does Of\215ineIMAP support POP?)108 247.2 Q F0 4.076(No. POP)144 259.2
R 1.576(is not rob)4.076 F 1.576(ust enough to do a completely reliable\
multi-machine synchronization lik)-.2 F(e)-.1 E(Of)144 165.6 Q
multi-machine synchronization lik)-.2 F(e)-.1 E(Of)144 271.2 Q
(\215ineIMAP can do.)-.25 E(Of)5 E(\215ineIMAP will not support it.)-.25
E F1(Do y)108 182.4 Q(ou support mailbox f)-.25 E
(ormats other than Maildir?)-.25 E F0 .41(Not at present.)144 194.4 R
.41(There is no technical reason not to; just no demand yet.)5.41 F .409
(Maildir is a superior for)5.409 F(-)-.2 E(mat an)144 206.4 Q(yw)-.15 E
(ay)-.1 E(.)-.65 E F1([technical] Wh)108 223.2 Q 2.5(ya)-.15 G .36 -.18
E F1(Do y)108 288 Q(ou support mailbox f)-.25 E
(ormats other than Maildir?)-.25 E F0 .41(Not at present.)144 300 R .41
(There is no technical reason not to; just no demand yet.)5.41 F .409
(Maildir is a superior for)5.409 F(-)-.2 E(mat an)144 312 Q(yw)-.15 E
(ay)-.1 E(.)-.65 E F1([technical] Wh)108 328.8 Q 2.5(ya)-.15 G .36 -.18
(re y)-2.5 H(our Maildir message \214lenames so huge?)-.07 E
(Of\215ineIMAP)144 235.2 Q F0 .958(has tw)3.458 F 3.458(or)-.1 G(ele)
(Of\215ineIMAP)144 340.8 Q F0 .958(has tw)3.458 F 3.458(or)-.1 G(ele)
-3.458 E -.25(va)-.25 G .958(nt principles: 1\) ne).25 F -.15(ve)-.25 G
3.459(rm).15 G .959(odifying your messages in an)-3.459 F 3.459(yw)-.15
G .959(ay and 2\))-3.559 F .493
(ensuring 100% reliable synchronizations.)144 247.2 R .493
(ensuring 100% reliable synchronizations.)144 352.8 R .493
(In order to do a reliable sync,)5.493 F F1(Of\215ineIMAP)2.993 E F0
.493(must ha)2.993 F -.15(ve)-.2 G 3.094(aw)144 259.2 S .594
.493(must ha)2.993 F -.15(ve)-.2 G 3.094(aw)144 364.8 S .594
(ay to uniquely identify each e-mail.)-3.194 F .595
(Three pieces of information are required to do this: your)5.594 F .538
(account name, the folder name, and the message UID.)144 271.2 R .537
(account name, the folder name, and the message UID.)144 376.8 R .537
(The account name can be calculated from)5.537 F 1.081
(the path in which your messages are.)144 283.2 R 1.082
(the path in which your messages are.)144 388.8 R 1.082
(The folder name can usually be as well, B)6.082 F 1.082(UT some mail)
-.1 F(clients mo)144 295.2 Q .3 -.15(ve m)-.15 H
-.1 F(clients mo)144 400.8 Q .3 -.15(ve m)-.15 H
(essages between folders by simply mo).15 E(ving the \214le, lea)-.15 E
(ving the name intact.)-.2 E(So,)144 312 Q F1(Of\215ineIMAP)3.2 E F0 .7
(must store both a UID folder ID.)3.2 F .7
(ving the name intact.)-.2 E(So,)144 417.6 Q F1(Of\215ineIMAP)3.2 E F0
.7(must store both a UID folder ID.)3.2 F .7
(The folder ID is necessary so)5.7 F F1(Of\215ineIMAP)3.2 E F0 .455
(can detect a message mo)144 324 R -.15(ve)-.15 G 2.955(dt).15 G 2.955
(can detect a message mo)144 429.6 R -.15(ve)-.15 G 2.955(dt).15 G 2.955
(oad)-2.955 G(if)-2.955 E .455(ferent folder)-.25 F(.)-.55 E F1
(Of\215ineIMAP)5.455 E F0 .456(stores the UID \(U= number\) and)2.955 F
(an md5sum of the foldername \(FMD5= number\) to f)144 336 Q
(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 352.8
Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 364.8 Q F0 -.15(ve)2.891 G
(an md5sum of the foldername \(FMD5= number\) to f)144 441.6 Q
(acilitate this.)-.1 E F1(What is the speed of Of\215ineIMAP')108 458.4
Q 2.5(ss)-.37 G(ync?)-2.5 E(Of\215ineIMAP)144 470.4 Q F0 -.15(ve)2.891 G
.391(rsions 2.0 and abo).15 F .691 -.15(ve c)-.15 H .391
(ontain a multithreaded system.).15 F 2.891(Ag)5.391 G .39(ood w)-2.891
F .39(ay to e)-.1 F(xperiment)-.15 E(is by setting maxsyncaccounts to 3\
and maxconnections to 3 in each account clause.)144 376.8 Q .381
(This lets Of)144 393.6 R .381
and maxconnections to 3 in each account clause.)144 482.4 Q .381
(This lets Of)144 499.2 R .381
(\215ineIMAP open up multiple connections simultaneously)-.25 F 5.382
(.T)-.65 G .382(hat will let it process mul-)-5.382 F
(tiple folders and messages at once.)144 405.6 Q
(tiple folders and messages at once.)144 511.2 Q
(In most cases, this will increase performance of the sync.)5 E(Don')144
422.4 Q 3.104(ts)-.18 G .604(et the number too high.)-3.104 F .603
528 Q 3.104(ts)-.18 G .604(et the number too high.)-3.104 F .603
(If you do that, things might actually slo)5.604 F 3.103(wd)-.25 G -.25
(ow)-3.103 G 3.103(na).25 G 3.103(sy)-3.103 G .603(our link gets)-3.103
F 2.632(saturated. Also,)144 434.4 R .132(too man)2.632 F 2.632(yc)-.15
G .132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F
.433 -.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633
(oad. Administra-).15 F .507(tors might tak)144 446.4 R 3.007(eu)-.1 G
F 2.632(saturated. Also,)144 540 R .132(too man)2.632 F 2.632(yc)-.15 G
.132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F .433
-.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633
(oad. Administra-).15 F .507(tors might tak)144 552 R 3.007(eu)-.1 G
.507(nkindly to this, and the serv)-3.007 F .506(er might bog do)-.15 F
3.006(wn. There)-.25 F .506(are man)3.006 F 3.006(yv)-.15 G .506
(ariables in the)-3.256 F(optimal setting; e)144 458.4 Q
(ariables in the)-3.256 F(optimal setting; e)144 564 Q
(xperimentation may help.)-.15 E
(An informal benchmark yields these results for my setup:)144 475.2 Q
(10 minutes with MacOS X Mail.app "manual cache")144 492 Q 2.5(5m)144
504 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 516 Q
(\215ineIMAP 1.x)-.25 E 2.5(9s)144 528 S(econds with Of)-2.5 E
(\215ineIMAP 2.x)-.25 E 2.5(3s)144 540 S(econds with Of)-2.5 E
(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 552 S(econds with Of)
(An informal benchmark yields these results for my setup:)144 580.8 Q
(10 minutes with MacOS X Mail.app "manual cache")144 597.6 Q 2.5(5m)144
609.6 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 621.6
Q(\215ineIMAP 1.x)-.25 E 2.5(9s)144 633.6 S(econds with Of)-2.5 E
(\215ineIMAP 2.x)-.25 E 2.5(3s)144 645.6 S(econds with Of)-2.5 E
(\215ineIMAP 3.x "cold start")-.25 E 2.5(2s)144 657.6 S(econds with Of)
-2.5 E(\215ineIMAP 3.x "held connection")-.25 E/F2 10.95/Times-Bold@0 SF
(CONFORMING T)72 568.8 Q(O)-.197 E F0 32.5<8349>108 580.8 S
(CONFORMING T)72 674.4 Q(O)-.197 E F0 32.5<8349>108 686.4 S
(nternet Message Access Protocol v)-32.5 E(ersion 4re)-.15 E
(v1 \(IMAP 4re)-.25 E(v1\) as speci\214ed in RFC2060)-.25 E 32.5<834d>
108 597.6 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
108 703.2 S 8.92(aildir as speci\214ed in http://www)-32.5 F(.qmail.or)
-.65 E(g/qmail-manual-html/man5/maildir)-.18 E 8.92(.html and)-.55 F
(http://cr)144 609.6 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E 32.5
<8353>108 626.4 S
(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
F2(NO)72 643.2 Q(TES)-.438 E F1(DELETING LOCAL FOLDERS)87 655.2 Q
(Of\215ineIMAP)108 667.2 Q F0 .533(does a tw)3.033 F(o-w)-.1 E .533
(ay synchronization.)-.1 F .532(That is, if you mak)5.532 F 3.032(eac)
-.1 G .532(hange to the mail on the serv)-3.032 F(er)-.15 E 3.032(,i)-.4
G(t)-3.032 E .896(will be propog)108 679.2 R .896
(ated to your local cop)-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65
F 3.397(ersa. Some)-.15 F .897(people might think that it w)3.397 F .897
(ould be wise to)-.1 F 1.59
(just delete all their local mail folders periodically)108 691.2 R 6.59
(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F(\215ineIMAP)
-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)108 703.2 Q
1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of).15 F 1.37
(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)3.87 E 1.37
(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)-3.87 F .416
(intentional deletion of man)108 715.2 R 2.916(ym)-.15 G .416(essages a\
nd will interpret your action as requesting them to be deleted from)
-2.916 F(the serv)108 727.2 Q(er as well.)-.15 E(\(If you don')5 E 2.5
(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18 G
(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
(ncounter this situation\))-2.5 E(John Goerzen)72 768 Q(July 12, 2002)
151.655 E(5)201.915 E EP
(http://cr)144 715.2 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
SF(COPYING MESSA)87 84 Q(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 96 Q
5.858(,w)-.65 G 3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E 32.5<8353>108 84 S
(tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
/F1 10.95/Times-Bold@0 SF(NO)72 100.8 Q(TES)-.438 E/F2 10/Times-Bold@0
SF(DELETING LOCAL FOLDERS)87 112.8 Q(Of\215ineIMAP)108 124.8 Q F0 .533
(does a tw)3.033 F(o-w)-.1 E .533(ay synchronization.)-.1 F .532
(That is, if you mak)5.532 F 3.032(eac)-.1 G .532
(hange to the mail on the serv)-3.032 F(er)-.15 E 3.032(,i)-.4 G(t)
-3.032 E .896(will be propog)108 136.8 R .896(ated to your local cop)
-.05 F 2.197 -.65(y, a)-.1 H .897(nd vise-v).65 F 3.397(ersa. Some)-.15
F .897(people might think that it w)3.397 F .897(ould be wise to)-.1 F
1.59(just delete all their local mail folders periodically)108 148.8 R
6.59(.I)-.65 G 4.09(fy)-6.59 G 1.59(ou do this with Of)-4.09 F
(\215ineIMAP)-.25 E 4.09(,r)-1.11 G 1.59(emember to also)-4.09 F(remo)
108 160.8 Q 1.67 -.15(ve y)-.15 H 1.37(our local status cache \(~/.of)
.15 F 1.37(\215ineimap by def)-.25 F 3.87(ault\). Otherwise,)-.1 F(Of)
3.87 E 1.37(\215ineIMAP will tak)-.25 F 3.87(et)-.1 G 1.37(his as an)
-3.87 F .416(intentional deletion of man)108 172.8 R 2.916(ym)-.15 G
.416(essages and will interpret your action as requesting them to be de\
leted from)-2.916 F(the serv)108 184.8 Q(er as well.)-.15 E
(\(If you don')5 E 2.5(tu)-.18 G(nderstand this, don')-2.5 E 2.5(tw)-.18
G(orry; you probably w)-2.6 E(on')-.1 E 2.5(te)-.18 G
(ncounter this situation\))-2.5 E F2(COPYING MESSA)87 201.6 Q
(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 213.6 Q 5.858(,w)-.65 G
3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359
(essage between folders or add a ne)-5.858 F 5.859(wm)-.25 G 3.359
(essage to a folder locally)-5.859 F(,)-.65 E F1(Of\215ineIMAP)108 108 Q
F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E -.15
(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
(essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 225.6
Q F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E
-.15(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F
3.353(y-)-.15 G 3.353(-i)-3.353 G 3.353(fy)-3.353 G .853(our IMAP serv)
-3.353 F(er)-.15 E .29(does not pro)108 120 R .29
(vide the SEARCH command, or does not return something useful,)-.15 F F1
-3.353 F(er)-.15 E .29(does not pro)108 237.6 R .29
(vide the SEARCH command, or does not return something useful,)-.15 F F2
(Of\215ineIMAP)2.79 E F0 .29(cannot deter)2.79 F(-)-.2 E .174
(mine the ne)108 132 R 2.674(wU)-.25 G .174(ID of the message.)-2.674 F
.173(So, in these rare instances, Of)5.173 F .173
(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108 144
R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55 G .64
(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)-.15 F
(wn-)-.25 E 1.473(loaded with the proper UID.)108 156 R F1
(mine the ne)108 249.6 R 2.674(wU)-.25 G .174(ID of the message.)-2.674
F .173(So, in these rare instances, Of)5.173 F .173
(\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108
261.6 R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55
G .64(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)
-.15 F(wn-)-.25 E 1.473(loaded with the proper UID.)108 273.6 R F2
(Of\215ineIMAP)6.473 E F0(mak)3.973 E 1.473(es sure that the message w)
-.1 F 1.472(as properly uploaded before)-.1 F
(deleting it, so there should be no risk of data loss.)108 168 Q F1
(MAILING LIST)87 184.8 Q F0(There is an Of)108 196.8 Q
(deleting it, so there should be no risk of data loss.)108 285.6 Q F2
(MAILING LIST)87 302.4 Q F0(There is an Of)108 314.4 Q
(\215ineIMAP mailing list a)-.25 E -.25(va)-.2 G(ilable.).25 E 2.447 -.8
(To s)108 213.6 T .847(ubscribe, send the te).8 F .847
(To s)108 331.2 T .847(ubscribe, send the te).8 F .847
(xt "Subscribe" in the subject of a mail to of)-.15 F
(\215ineimap-request@complete.or)-.25 E 3.348(g. T)-.18 F(o)-.8 E
(post, send the message to of)108 225.6 Q(\215ineimap@complete.or)-.25 E
(g.)-.18 E/F2 10.95/Times-Bold@0 SF -.11(BU)72 242.4 S(GS).11 E F0 4.42
(Reports of b)108 254.4 R 4.419(ugs should be sent via e-mail to the)-.2
F F1(Of\215ineIMAP)6.919 E F0 -.2(bu)6.919 G 4.419
(g-tracking system \(BTS\) at).2 F(of)108 266.4 Q(\215ineimap@b)-.25 E
(ugs.complete.or)-.2 E 3.396(go)-.18 G 3.396(rs)-3.396 G .897
(ubmitted on-line using the W)-3.396 F .897(eb interf)-.8 F .897
(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108 278.4
Q(eb site also lists all current b)-.8 E
(post, send the message to of)108 343.2 Q(\215ineimap@complete.or)-.25 E
(g.)-.18 E F1 -.11(BU)72 360 S(GS).11 E F0 4.42(Reports of b)108 372 R
4.419(ugs should be sent via e-mail to the)-.2 F F2(Of\215ineIMAP)6.919
E F0 -.2(bu)6.919 G 4.419(g-tracking system \(BTS\) at).2 F(of)108 384 Q
(\215ineimap@b)-.25 E(ugs.complete.or)-.2 E 3.396(go)-.18 G 3.396(rs)
-3.396 G .897(ubmitted on-line using the W)-3.396 F .897(eb interf)-.8 F
.897(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108
396 Q(eb site also lists all current b)-.8 E
(ugs, where you can check their status or contrib)-.2 E
(ute to \214xing them.)-.2 E F2(COPYRIGHT)72 295.2 Q F0(Of)108 307.2 Q
(ute to \214xing them.)-.2 E F1(COPYRIGHT)72 412.8 Q F0(Of)108 424.8 Q
(\215ineIMAP is Cop)-.25 E(yright \(C\) 2002 John Goerzen.)-.1 E .287
(This program is free softw)108 324 R .287(are; you can redistrib)-.1 F
.286(ute it and/or modify it under the terms of the GNU General)-.2 F
.766(Public License as published by the Free Softw)108 336 R .766(are F)
-.1 F .766(oundation; either v)-.15 F .766
(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 348 Q 2.5
(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib)108
364.8 R .579(uted in the hope that it will be useful, b)-.2 F .579
(This program is free softw)108 441.6 R .287(are; you can redistrib)-.1
F .286(ute it and/or modify it under the terms of the GNU General)-.2 F
.766(Public License as published by the Free Softw)108 453.6 R .766
(are F)-.1 F .766(oundation; either v)-.15 F .766
(ersion 2 of the License, or \(at your)-.15 F(option\) an)108 465.6 Q
2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib)
108 482.4 R .579(uted in the hope that it will be useful, b)-.2 F .579
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.079(;w)-.92 G(ithout)-3.079 E
-2.15 -.25(ev e)108 376.8 T 2.729(nt).25 G .229(he implied w)-2.729 F
-2.15 -.25(ev e)108 494.4 T 2.729(nt).25 G .229(he implied w)-2.729 F
.229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F
(AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E
(the GNU General Public License for more details.)108 388.8 Q -1.1(Yo)
108 405.6 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
(the GNU General Public License for more details.)108 506.4 Q -1.1(Yo)
108 523.2 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
.15 E -.15(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)
-2.77 G .27
(he GNU General Public License along with this program; if not, write)
-2.77 F(to:)108 417.6 Q(Free Softw)108 434.4 Q(are F)-.1 E
(oundation, Inc.)-.15 E(59 T)108 446.4 Q(emple Place)-.7 E(Suite 330)108
458.4 Q(Boston, MA)108 470.4 Q(02111-1307)5 E(USA)108 482.4 Q F2 -.548
(AU)72 499.2 S(THOR).548 E F1(Of\215ineIMAP)108 511.2 Q(,)-.92 E F0 .488
-2.77 F(to:)108 535.2 Q(Free Softw)108 552 Q(are F)-.1 E
(oundation, Inc.)-.15 E(59 T)108 564 Q(emple Place)-.7 E(Suite 330)108
576 Q(Boston, MA)108 588 Q(02111-1307)5 E(USA)108 600 Q F1 -.548(AU)72
616.8 S(THOR).548 E F2(Of\215ineIMAP)108 628.8 Q(,)-.92 E F0 .488
(its libraries, documentation, and all included \214les, e)2.987 F .488
(xcept where noted, w)-.15 F .488(as written by John)-.1 F
(Goerzen <jgoerzen@complete.or)108 523.2 Q(g> and cop)-.18 E
(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 540 Q
(Goerzen <jgoerzen@complete.or)108 640.8 Q(g> and cop)-.18 E
(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 657.6 Q
(\215ineIMAP may be do)-.25 E(wnloaded, and information found, from its\
homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 556.8 Q
homepage via either Gopher or HTTP:)-.25 E(gopher://quux.or)108 674.4 Q
(g/1/de)-.18 E -.15(ve)-.25 G(l/of).15 E(\215ineimap)-.25 E
(http://quux.or)108 568.8 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap)-.25 E(Of)108 585.6 Q 2.529(\215ineIMAP may also be do)-.25
(http://quux.or)108 686.4 Q(g/de)-.18 E -.15(ve)-.25 G(l/of).15 E
(\215ineimap)-.25 E(Of)108 703.2 Q 2.529(\215ineIMAP may also be do)-.25
F 2.528(wnloaded using Sub)-.25 F -.15(ve)-.15 G 5.028
(rsion. Additionally).15 F 5.028(,t)-.65 G 2.528(he distrib)-5.028 F
2.528(uted tar)-.2 F 2.528(.gz may be)-.55 F .717
(updated with a simple "svn update" command; it is ready to go.)108
597.6 R -.15(Fo)5.718 G 3.218(ri).15 G .718(nformation on getting Of)
-3.218 F(\215ineIMAP)-.25 E(with Sub)108 609.6 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(http://svn.complete.or)108 626.4 Q(g/)-.18 E
F2(SEE ALSO)72 643.2 Q F1(mutt)108 655.2 Q F0(\(1\),)A F1(python)2.5 E
F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655 E(6)201.915 E EP
715.2 R -.15(Fo)5.718 G 3.218(ri).15 G .718(nformation on getting Of)
-3.218 F(\215ineIMAP)-.25 E(with Sub)108 727.2 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(John Goerzen)72 768 Q(July 12, 2002)151.655
E(6)201.915 E EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R
(\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E
(http://svn.complete.or)108 84 Q(g/)-.18 E/F1 10.95/Times-Bold@0 SF
(SEE ALSO)72 100.8 Q/F2 10/Times-Bold@0 SF(mutt)108 112.8 Q F0(\(1\),)A
F2(python)2.5 E F0(\(1\).)A(John Goerzen)72 768 Q(July 12, 2002)151.655
E(7)201.915 E EP
%%Trailer
end
%%EOF

156
offlineimap/head/manual.txt
View File

@ -7,112 +7,112 @@ NAME
reader support
SYNOPSIS
offlineimap [ -1 ] [ -a accountlist ] [ -c configfile ]
[ -d ] [ -o ] [ -u interface ]
offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [
-c configfile ] [ -d ] [ -o ] [ -u interface ]
offlineimap -h | --help
DESCRIPTION
OfflineIMAP is a tool to simplify your e-mail reading.
With OfflineIMAP, you can read the same mailbox from mul-
tiple computers. You get a current copy of your messages
on each computer, and changes you make one place will be
visible on all other systems. For instance, you can
OfflineIMAP is a tool to simplify your e-mail reading.
With OfflineIMAP, you can read the same mailbox from mul-
tiple computers. You get a current copy of your messages
on each computer, and changes you make one place will be
visible on all other systems. For instance, you can
delete a message on your home computer, and it will appear
deleted on your work computer as well. OfflineIMAP is
deleted on your work computer as well. OfflineIMAP is
also useful if you want to use a mail reader that does not
have IMAP support, has poor IMAP support, or does not pro-
vide disconnected operation.
OfflineIMAP is FAST; it synchronizes my two accounts with
over 50 folders in 3 seconds. Other similar tools might
take over a minute, and achieve a less-reliable result.
Some mail readers can take over 10 minutes to do the same
thing, and some don't even support it at all. Unlike
other mail tools, OfflineIMAP features a multi-threaded
synchronization algorithm that can dramatically speed up
performance in many situations by synchronizing several
OfflineIMAP is FAST; it synchronizes my two accounts with
over 50 folders in 3 seconds. Other similar tools might
take over a minute, and achieve a less-reliable result.
Some mail readers can take over 10 minutes to do the same
thing, and some don't even support it at all. Unlike
other mail tools, OfflineIMAP features a multi-threaded
synchronization algorithm that can dramatically speed up
performance in many situations by synchronizing several
different things simultaneously.
OfflineIMAP is FLEXIBLE; you can customize which folders
are synced via regular expressions, lists, or Python
expressions; a versatile and comprehensive configuration
file is used to control behavior; two user interfaces are
built-in; fine-tuning of synchronization performance is
possible; internal or external automation is supported;
SSL and PREAUTH tunnels are both supported; offline (or
"unplugged") reading is supported; and esoteric IMAP fea-
tures are supported to ensure compatibility with the
OfflineIMAP is FLEXIBLE; you can customize which folders
are synced via regular expressions, lists, or Python
expressions; a versatile and comprehensive configuration
file is used to control behavior; two user interfaces are
built-in; fine-tuning of synchronization performance is
possible; internal or external automation is supported;
SSL and PREAUTH tunnels are both supported; offline (or
"unplugged") reading is supported; and esoteric IMAP fea-
tures are supported to ensure compatibility with the
widest variety of IMAP servers.
OfflineIMAP is SAFE; it uses an algorithm designed to pre-
vent mail loss at all costs. Because of the design of
this algorithm, even programming errors should not result
in loss of mail. I am so confident in the algorithm that
I use my own personal and work accounts for testing of
vent mail loss at all costs. Because of the design of
this algorithm, even programming errors should not result
in loss of mail. I am so confident in the algorithm that
I use my own personal and work accounts for testing of
OfflineIMAP pre-release, development, and beta releases.
METHOD OF OPERATION
OfflineIMAP operates by maintaining a hierarchy of mail
folders in Maildir format locally. Your own mail reader
will read mail from this tree, and need never know that
OfflineIMAP operates by maintaining a hierarchy of mail
folders in Maildir format locally. Your own mail reader
will read mail from this tree, and need never know that
the mail comes from IMAP. OfflineIMAP will detect changes
to the mail folders on your IMAP server and your own com-
to the mail folders on your IMAP server and your own com-
puter and bi-directionally synchronize them, copying,
marking, and deleting messages as necessary.
INSTALLATION
If you are reading this document via the "man" command, it
is likely that you have no installation tasks to perform;
your system administrator has already installed it. If
is likely that you have no installation tasks to perform;
your system administrator has already installed it. If
you need to install it yourself, you have three options: a
system-wide installation with Debian, system-wide instal-
system-wide installation with Debian, system-wide instal-
lation with other systems, and a single-user installation.
You can download the latest version of OfflineIMAP from
You can download the latest version of OfflineIMAP from
http://quux.org/devel/offlineimap/.
PREREQUISITES
In order to use OfflineIMAP, you need to have these condi-
tions satisfied:
o Your mail server must support IMAP. Most Internet
Service Providers and corporate networks do, and
most operating systems have an IMAP implementation
o Your mail server must support IMAP. Most Internet
Service Providers and corporate networks do, and
most operating systems have an IMAP implementation
readily available.
o You must have Python version 2.2.1 or above
o You must have Python version 2.2.1 or above
installed. If you are running on Debian GNU/Linux,
this requirement will automatically be taken care
of for you. If you do not have Python already,
check with your system administrator or operating
system vendor; or, download it from
http://www.python.org/. If you intend to use the
Tk interface, you must have Tkiner (python-tk)
this requirement will automatically be taken care
of for you. If you do not have Python already,
check with your system administrator or operating
system vendor; or, download it from
http://www.python.org/. If you intend to use the
Tk interface, you must have Tkiner (python-tk)
installed. If you intend to use the SSL interface,
your Python must have been built with SSL support.
your Python must have been built with SSL support.
o Have a mail reader that supports the Maildir mail-
box format. Most modern mail readers have this
support built-in, so you can choose from a wide
o Have a mail reader that supports the Maildir mail-
box format. Most modern mail readers have this
support built-in, so you can choose from a wide
variety of mail servers. This format is also known
as the "qmail" format, so any mail reader compati-
as the "qmail" format, so any mail reader compati-
ble with it will work with OfflineIMAP.
DEBIAN SYSTEM-WIDE INSTALLATION
If you are tracking Debian unstable, you may install
OfflineIMAP by simply running the following command as
If you are tracking Debian unstable, you may install
OfflineIMAP by simply running the following command as
root:
apt-get install offlineimap
If you are not tracking Debian unstable, download the
Debian .deb package from the OfflineIMAP website and then
run dpkg -i to install the downloaded package. Then, go
to CONFIGURATION below. You will type offlineimap to
If you are not tracking Debian unstable, download the
Debian .deb package from the OfflineIMAP website and then
run dpkg -i to install the downloaded package. Then, go
to CONFIGURATION below. You will type offlineimap to
invoke the program.
OTHER SYSTEM-WIDE INSTALLATION
Download the tar.gz version of the package from the web-
Download the tar.gz version of the package from the web-
site. Then run these commands:
tar -zxvf offlineimap-x.y.z.tar.gz
@ -124,35 +124,48 @@ INSTALLATION
to invoke the program.
SINGLE-ACCOUNT INSTALLATION
Download the tar.gz version of the package from the web-
Download the tar.gz version of the package from the web-
site. Then run these commands:
tar -zxvf offlineimap-x.y.z.tar.gz
cd offlineimap-x.y.z
When you want to run OfflineIMAP, you will issue the cd
command as above and then type ./offlineimap; there is no
When you want to run OfflineIMAP, you will issue the cd
command as above and then type ./offlineimap; there is no
installation step necessary.
CONFIGURATION
OfflineIMAP is regulated by a configuration file that is
normally stored in ~/.offlineimaprc. OfflineIMAP ships
OfflineIMAP is regulated by a configuration file that is
normally stored in ~/.offlineimaprc. OfflineIMAP ships
with a file named offlineimap.conf that you should copy to
that location and then edit. This file is vital to proper
operation of the system; it sets everything you need to
operation of the system; it sets everything you need to
run OfflineIMAP. Full documentation for the configuration
file is included within the sample file.
OPTIONS
Most configuration is done via the configuration file.
Most configuration is done via the configuration file.
Nevertheless, there are a few options that you may set for
OfflineIMAP.
-1 Disable all multithreading operations and use
-1 Disable all multithreading operations and use
solely a single-thread sync. This effectively sets
the maxsyncaccounts and all maxconnections configu-
ration file variables to 1.
-P profiledir
Sets OfflineIMAP into profile mode. The program
will create profiledir (it must not already exist).
As it runs, Python profiling information about each
thread is logged into profiledir. Please note:
This option is present for debugging and optimiza-
tion only, and should NOT be used unless you have a
specific reason to do so. It will significantly
slow program performance, may reduce reliability,
and can generate huge amounts of data. You must
use the -1 option when you use -P.
-a accountlist
Overrides the accounts section in the config file.
Lets you specify a particular account or set of
@ -261,8 +274,8 @@ ERRORS
UID validity problem for folder
IMAP servers use a unique ID (UID) to refer to a specific
message. This number is guaranteed to be unique to a
particular message FOREVER. No other message in the same
message. This number is guaranteed to be unique to a par-
ticular message FOREVER. No other message in the same
folder will ever get the same UID. UIDs are an integral
part of OfflineIMAP's synchronization scheme; they are
used to match up messages on your computer to messages on
@ -380,8 +393,8 @@ OTHER FREQUENTLY ASKED QUESTIONS
The folder ID is necessary so OfflineIMAP can
detect a message moved to a different folder.
OfflineIMAP stores the UID (U= number) and an
md5sum of the foldername (FMD5= number) to facili-
tate this.
md5sum of the foldername (FMD5= number) to
facilitate this.
What is the speed of OfflineIMAP's sync?
OfflineIMAP versions 2.0 and above contain a multi-
@ -516,4 +529,3 @@ SEE ALSO
John Goerzen July 12, 2002 OFFLINEIMAP(1)

21
offlineimap/head/offlineimap.1
View File

@ -23,12 +23,15 @@ OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support
.BI \-1
]
[
.BI \-P \ profiledir
]
[
.BI \-a \ accountlist
]
[
.BI \-c \ configfile
]
.br
.\".br
[
.BI \-d
]
@ -217,6 +220,22 @@ sync. This effectively sets the
and all
.B maxconnections
configuration file variables to 1.
.TP
.BI \-P \ profiledir
Sets
.B OfflineIMAP
into profile mode. The program will create
.B profiledir
(it must not already exist). As it runs, Python profiling information
about each thread is logged into profiledir. Please note: This option
is present for debugging and optimization only, and should NOT be used
unless you have a specific reason to do so. It will significantly
slow program performance, may reduce reliability, and can generate
huge amounts of data. You must use the
.B \-1
option when you use
.B -P.
.TP
.BI \-a \ accountlist
Overrides the

11
offlineimap/head/offlineimap.py
View File

@ -29,7 +29,7 @@ if '--help' in sys.argv[1:]:
sys.stdout.write(version.cmdhelp + "\n")
sys.exit(0)
for optlist in getopt(sys.argv[1:], '1oa:c:du:h')[0]:
for optlist in getopt(sys.argv[1:], 'P:1oa:c:du:h')[0]:
options[optlist[0]] = optlist[1]
if '-d' in options:
@ -41,6 +41,15 @@ if '-h' in options:
configfilename = os.path.expanduser("~/.offlineimaprc")
if '-c' in options:
configfilename = options['-c']
if '-P' in options:
if not '-1' in options:
sys.stderr.write("FATAL: profile mode REQUIRES -1\n")
sys.exit(100)
profiledir = options['-P']
os.mkdir(profiledir)
threadutil.setprofiledir(profiledir)
sys.stderr.write("WARNING: profile mode engaged;\n{otentially large data will be created in " + profiledir + "\n")
config = ConfigParser()

22
offlineimap/head/offlineimap/threadutil.py
View File

@ -18,7 +18,13 @@
from threading import *
from StringIO import StringIO
import sys, traceback, thread
import sys, traceback, thread, profile
profiledir = None
def setprofiledir(newdir):
global profiledir
profiledir = newdir
######################################################################
# General utilities
@ -81,10 +87,20 @@ class ExitNotifyThread(Thread):
"""This class is designed to alert a "monitor" to the fact that a thread has
exited and to provide for the ability for it to find out why."""
def run(self):
global exitcondition, exitthreads
global exitcondition, exitthreads, profiledir
self.threadid = thread.get_ident()
try:
Thread.run(self)
if not profiledir: # normal case
Thread.run(self)
else:
prof = profile.Profile()
try:
prof = prof.runctx("Thread.run(self)", globals(), locals())
except SystemExit:
pass
prof.dump_stats( \
profiledir + "/" + str(self.threadid) + "_" + \
self.getName() + ".prof")
except:
self.setExitCause('EXCEPTION')
self.setExitException(sys.exc_info()[1])

42
offlineimap/head/offlineimap/version.py
View File

@ -1,8 +1,8 @@
productname = 'OfflineIMAP'
versionstr = "3.0.3"
revno = long('$Rev: 152 $'[6:-2])
revno = long('$Rev: 164 $'[6:-2])
revstr = "Rev %d" % revno
datestr = '$Date: 2002-07-21 15:46:40 -0500 (Sun, 21 Jul 2002) $'
datestr = '$Date: 2002-07-22 15:48:15 -0500 (Mon, 22 Jul 2002) $'
versionlist = versionstr.split(".")
@ -40,16 +40,29 @@ along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA"""
cmdhelp = """
offlineimap [ -1 ] [ -a accountlist ] [ -c configfile ]
[ -d ] [ -u interface ]
offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [
-c configfile ] [ -d ] [ -o ] [ -u interface ]
offlineimap -h | --help
-1 Disable all multithreading operations and use
-1 Disable all multithreading operations and use
solely a single-thread sync. This effectively sets
the maxsyncaccounts and all maxconnections configu-
ration file variables to 1.
-P profiledir
Sets OfflineIMAP into profile mode. The program
will create profiledir (it must not already exist).
As it runs, Python profiling information about each
thread is logged into profiledir. Please note:
This option is present for debugging and optimiza-
tion only, and should NOT be used unless you have a
specific reason to do so. It will significantly
slow program performance, may reduce reliability,
and can generate huge amounts of data. You must
use the -1 option when you use -P.
-a accountlist
Overrides the accounts section in the config file.
Lets you specify a particular account or set of
@ -72,14 +85,23 @@ cmdhelp = """
remove that from the debugging output before send-
ing it to anyone else.
-o Run only once, ignoring any autorefresh setting in
the config file.
-h, --help
Show summary of options.
-u interface
Specifies an alternative user interface module to
use. This overrides the default specified in the
configuration file. The UI specified with -u will
be forced to be used, even if its isuable() method
states that it cannot be. Use this option with
Specifies an alternative user interface module to
use. This overrides the default specified in the
configuration file. The UI specified with -u will
be forced to be used, even if its isuable() method
states that it cannot be. Use this option with
care.
The pre-defined options are Tk.TKUI (a graphical
interface), TTY.TTYUI (a text-mode interface), Non-
interactive.Basic (a non-interactive mode suitable
for cronning), and Noninteractive.Quiet (a mode
that generates no output except for errors).
"""