diff --git a/offlineimap/head/debian/changelog b/offlineimap/head/debian/changelog index 3bec7fa..0c86393 100644 --- a/offlineimap/head/debian/changelog +++ b/offlineimap/head/debian/changelog @@ -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 Sun, 21 Jul 2002 16:09:42 -0500 diff --git a/offlineimap/head/manual.html b/offlineimap/head/manual.html index 11145ef..e3f5950 100644 --- a/offlineimap/head/manual.html +++ b/offlineimap/head/manual.html @@ -25,7 +25,7 @@
- +

NAME

-offlineimap [ -1 ] [ -a -accountlist ] [ -c configfile ]
-[ -d ] [ -o ] [ -u interface -]
+offlineimap [ -1 ] [ -P +profiledir ] [ -a accountlist ] [ +-c configfile ] [ -d ] [ -o ] [ +-u interface ] @@ -320,6 +320,27 @@ single-thread sync. This effectively sets the maxsyncaccounts and all maxconnections configuration 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 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 -1 option when you use +-P.
+ diff --git a/offlineimap/head/manual.pdf b/offlineimap/head/manual.pdf index e62b4bd..7839100 100644 Binary files a/offlineimap/head/manual.pdf and b/offlineimap/head/manual.pdf differ diff --git a/offlineimap/head/manual.ps b/offlineimap/head/manual.ps index ffcfb94..f3b3b15 100644 --- a/offlineimap/head/manual.ps +++ b/offlineimap/head/manual.ps @@ -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 F22.5 E F0 2.5(][)2.5 G F2A/F3 10/Times-Italic@0 SF -(accountlist)2.5 E F0 2.5(][)2.5 G F2A F3(con\214g\214le)2.5 E F0 -(])2.5 E([)108 136.8 Q F22.5 E F0 2.5(][)2.5 G F2A F0 2.5 -(][)2.5 G F2A 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 F22.5 E F0 2.5(][)2.5 G F2A/F3 10/Times-Italic@0 SF +(pr)2.5 E(o\214ledir)-.45 E F0 2.5(][)2.5 G F2A F3(accountlist)2.5 +E F0 2.5(][)2.5 G F2A F3(con\214g\214le)2.5 E F0 2.5(][)2.5 G F2 +A F0 2.5(][)2.5 G F2A F0 2.5(][)2.5 G F2A 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 F1108 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 F1108 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 F12.5 E F0(option when you use)2.5 E F1(-P)2.5 +E(.)-1.1 E108 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 F1108 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 -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 F1108 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 F1108 +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 -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 F1108 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 -SF108 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 +SF144 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 F1108 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 F1108 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 and cop)-.18 E -(yright is held as stated in the COPYRIGHT section.)-.1 E(Of)108 540 Q +(Goerzen 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 diff --git a/offlineimap/head/manual.txt b/offlineimap/head/manual.txt index 645fb90..8db4b1d 100644 --- a/offlineimap/head/manual.txt +++ b/offlineimap/head/manual.txt @@ -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) diff --git a/offlineimap/head/offlineimap.1 b/offlineimap/head/offlineimap.1 index bd35de7..e918b7c 100644 --- a/offlineimap/head/offlineimap.1 +++ b/offlineimap/head/offlineimap.1 @@ -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 diff --git a/offlineimap/head/offlineimap.py b/offlineimap/head/offlineimap.py index 491f8aa..7bcd552 100644 --- a/offlineimap/head/offlineimap.py +++ b/offlineimap/head/offlineimap.py @@ -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() diff --git a/offlineimap/head/offlineimap/threadutil.py b/offlineimap/head/offlineimap/threadutil.py index cc638c7..3f78417 100644 --- a/offlineimap/head/offlineimap/threadutil.py +++ b/offlineimap/head/offlineimap/threadutil.py @@ -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]) diff --git a/offlineimap/head/offlineimap/version.py b/offlineimap/head/offlineimap/version.py index 14b4e56..b8554dc 100644 --- a/offlineimap/head/offlineimap/version.py +++ b/offlineimap/head/offlineimap/version.py @@ -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). """