/offlineimap/head: changeset 164

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

View File

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

View File

@ -25,7 +25,7 @@
<hr> <hr>
<!-- Creator : groff version 1.17.2 --> <!-- 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> <a name="NAME"></a>
<h2>NAME</h2> <h2>NAME</h2>
<table width="100%" border=0 rules="none" frame="void" <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"> cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"> <tr valign="top" align="left">
<td width="10%"></td><td width="90%"> <td width="10%"></td><td width="90%">
<b>offlineimap</b> [ <b>-1</b> ] [ <b>-a</b> <b>offlineimap</b> [ <b>-1</b> ] [ <b>-P</b>
<i>accountlist</i> ] [ <b>-c</b> <i>configfile</i> ]<br> <i>profiledir</i> ] [ <b>-a</b> <i>accountlist</i> ] [
[ <b>-d</b> ] [ <b>-o</b> ] [ <b>-u</b> <i>interface</i> <b>-c</b> <i>configfile</i> ] [ <b>-d</b> ] [ <b>-o</b> ] [
]</td></table> <b>-u</b> <i>interface</i> ]</td></table>
<table width="100%" border=0 rules="none" frame="void" <table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0"> 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> <b>maxsyncaccounts</b> and all <b>maxconnections</b>
configuration file variables to 1.</td></table> 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" <table width="100%" border=0 rules="none" frame="void"
cols="2" cellspacing="0" cellpadding="0"> cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"> <tr valign="top" align="left">

Binary file not shown.

View File

@ -1,11 +1,11 @@
%!PS-Adobe-3.0 %!PS-Adobe-3.0
%%Creator: groff version 1.17.2 %%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 %%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold %%+ font Times-Bold
%%+ font Times-Italic %%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.17 2 %%DocumentSuppliedResources: procset grops 1.17 2
%%Pages: 6 %%Pages: 7
%%PageOrder: Ascend %%PageOrder: Ascend
%%Orientation: Portrait %%Orientation: Portrait
%%EndComments %%EndComments
@ -210,111 +210,111 @@ BP
(\215ineIMAP \255 Po)-.25 E (\215ineIMAP \255 Po)-.25 E
(werful IMAP/Maildir synchronization and reader support)-.25 E F1 (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 (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 ([)2.5 E F2<ad31>2.5 E F0 2.5(][)2.5 G F2<ad50>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 (pr)2.5 E(o\214ledir)-.45 E F0 2.5(][)2.5 G F2<ad61>A F3(accountlist)2.5
(])2.5 E([)108 136.8 Q F2<ad64>2.5 E F0 2.5(][)2.5 G F2<ad6f>A F0 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
(][)2.5 G F2<ad75>A F3(interface)2.5 E F0(])2.5 E F2 <ad64>A F0 2.5(][)2.5 G F2<ad6f>A F0 2.5(][)2.5 G F2<ad75>A F3
(of\215ineimap \255h)108 160.8 Q F0(|)2.5 E F2(\255\255help)2.5 E F1 (interface)2.5 E F0(])2.5 E F2(of\215ineimap \255h)108 148.8 Q F0(|)2.5
(DESCRIPTION)72 177.6 Q F2(Of\215ineIMAP)108 189.6 Q F0 .019 E F2(\255\255help)2.5 E F1(DESCRIPTION)72 165.6 Q F2(Of\215ineIMAP)108
(is a tool to simplify your e-mail reading.)2.519 F -.4(Wi)5.019 G(th).4 177.6 Q F0 .019(is a tool to simplify your e-mail reading.)2.519 F -.4
E F2(Of\215ineIMAP)2.519 E(,)-.92 E F0 .018 (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.) (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) 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(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 -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 (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 (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 (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 .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 (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 (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 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 (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 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 (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 (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) 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) 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\ 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 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 314.4 Q -.15 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 (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) (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 (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 (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\ (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 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 (UTH tunnels are both supported; of)-.55 F .44
(\215ine \(or "unplugged"\) reading is sup-)-.25 F .543(ported; and eso\ (\215ine \(or "unplugged"\) reading is sup-)-.25 F .543(ported; and eso\
teric IMAP features are supported to ensure compatibility with the wide\ 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 st v)108 367.2 R .544(ariety of IMAP)-.25 F(serv)108 379.2 Q(ers.)-.15 E
F2(Of\215ineIMAP)108 408 Q F0(is)4.065 E F3(SAFE;)4.065 E F0 1.565 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 (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 (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) (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) 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 (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 (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 (lop-).15 E(ment, and beta releases.)108 432 Q F2(METHOD OF OPERA)87
460.8 Q(TION)-.95 E(Of\215ineIMAP)108 472.8 Q F0 .07 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 (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 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 (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 -.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 (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 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) 484.8 R .849(er and your o)-.15 F .849(wn computer and bi-directionally)
-.25 F(synchronize them, cop)108 508.8 Q -.25 F(synchronize them, cop)108 496.8 Q
(ying, marking, and deleting messages as necessary)-.1 E(.)-.65 E F1 (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 (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 (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 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\ (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 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 (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 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 (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 602.4 Q(UISITES)-.1 E F0 (\215ineimap/.)-.25 E F2(PREREQ)87 590.4 Q(UISITES)-.1 E F0
(In order to use Of)108 614.4 Q(\215ineIMAP)-.25 E 2.5(,y)-1.11 G (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:) (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 (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 (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 (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 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 (ve i)-.15 H 2.585(nstalled. If).15 F .086
(you are running on Debian GNU/Linux,)2.585 F .813 (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 (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 (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) 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 .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 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 .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 (July 12, 2002)151.655 E(1)201.915 E EP
%%Page: 2 2 %%Page: 2 2
%%BeginPageSetup %%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 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 (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 (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 (con\214guration \214le v)2.5 E(ariables to 1.)-.25 E F1<ad50>108 542.4
Q F3(accountlist)2.5 E F0(Ov)144 554.4 Q .84(errides the)-.15 F F1 Q F3(pr)2.5 E(o\214ledir)-.45 E F0(Sets)144 554.4 Q F1(Of\215ineIMAP)
(accounts)3.34 E F0 .84(section in the con\214g \214le.)3.34 F .84 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 (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 (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 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 (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 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 (Speci\214es a con\214guration \214le to use in lieu of the def)144 696
607.2 Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F1 Q(ault,)-.1 E F3(~/.of)2.5 E(\215ineimapr)-.18 E(c.)-.37 E F1<ad64>108
<ad64>108 624 Q F0 1.139(Enables IMAP protocol stream and parsing deb) 712.8 Q F0 1.139(Enables IMAP protocol stream and parsing deb)24.74 F
24.74 F 3.639(ugging. This)-.2 F 1.138 3.639(ugging. This)-.2 F 1.138(is useful if you are trying to track)
(is useful if you are trying to track)3.639 F(do)144 636 Q .081 3.639 F(do)144 724.8 Q .081
(wn a malfunction or \214gure out what is going on under the hood.)-.25 (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> F 2.582(Is)5.082 G .082(uggest that you use this with)-2.582 F
144 648 Q F0 .336(in order to mak)2.836 F 2.836(et)-.1 G .335 (John Goerzen)72 768 Q(July 12, 2002)151.655 E(2)201.915 E EP
(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
%%Page: 3 3 %%Page: 3 3
%%BeginPageSetup %%BeginPageSetup
BP BP
%%EndPageSetup %%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R /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 (\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 SF<ad31>144 84 Q F0 .336(in order to mak)2.836 F 2.836(et)-.1 G .335
(Speci\214es an alternati)144 96 R 1.433 -.15(ve u)-.25 H 1.133 (he results more sensible.)-2.836 F .335
(ser interf).15 F 1.133(ace module to use.)-.1 F 1.133(This o)6.133 F (Note that this output will contain full IMAP proto-)5.335 F 1.7
-.15(ve)-.15 G 1.133(rrides the def).15 F 1.132(ault speci\214ed in the) (col in plain te)144 96 R 1.7(xt, including passw)-.15 F 1.7
-.1 F .28(con\214guration \214le.)144 108 R .28(The UI speci\214ed with) (ords, so tak)-.1 F 4.2(ec)-.1 G 1.7(are to remo)-4.2 F 2 -.15(ve t)-.15
5.28 F F1(-u)2.78 E F0 .281(will be forced to be used, e)2.78 F -.15(ve) H 1.7(hat from the deb).15 F 1.7(ugging output)-.2 F
-.25 G 2.781(ni).15 G 2.781(fi)-2.781 G(ts)-2.781 E F1(isuable\(\))2.781 (before sending it to an)144 108 Q(yone else.)-.15 E F1<ad6f>108 124.8 Q
E F0(method)2.781 E(states that it cannot be.)144 120 Q F0(Run only once, ignoring an)25.3 E 2.5(ya)-.15 G
(Use this option with care.)5 E 1.485(The pre-de\214ned options are)144 (utorefresh setting in the con\214g \214le.)-2.5 E F1
136.8 R F1(Tk.TKUI)3.985 E F0 1.485(\(a graphical interf)3.985 F(ace\),) (\255h, \255\255help)108 141.6 Q F0(Sho)144 153.6 Q 2.5(ws)-.25 G
-.1 E F1(TTY)3.984 E(.TTYUI)-.92 E F0 1.484(\(a te)3.984 F 1.484 (ummary of options.)-2.5 E F1<ad75>108 170.4 Q/F2 10/Times-Italic@0 SF
(xt-mode inter)-.15 F(-)-.2 E -.1(fa)144 148.8 S(ce\),).1 E F1 (interface)2.5 E F0 1.133(Speci\214es an alternati)144 182.4 R 1.433
(Noninteracti)5.044 E -.1(ve)-.1 G(.Basic).1 E F0 2.544 -.15(ve u)-.25 H 1.133(ser interf).15 F 1.133(ace module to use.)-.1 F
(\(a non-interacti)5.044 F 2.844 -.15(ve m)-.25 H 2.545 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 (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 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 (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 (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) (MUL)87 292.8 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 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 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 (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 316.8 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 333.6 Q F1(mkdir ~/Mail)108 345.6 Q F0(In your)108 362.4 Q F2(~/.of)2.5
(\215ineimapr)-.18 E(c,)-.37 E F0(specify this:)2.5 E F1(accounts = P) 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 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) .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 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) 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 -.25 F(enable)108 403.2 Q F1([mbnames].)2.5 E F0
(In each account section, do something lik)108 333.6 Q 2.5(et)-.1 G (In each account section, do something lik)108 420 Q 2.5(et)-.1 G(his:)
(his:)-2.5 E F1(localf)108 345.6 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2 -2.5 E F1(localf)108 432 Q(olders = ~/Mail/P)-.25 E(ersonal)-.2 E F0
E F0(Add these lines to your)108 362.4 Q F2(~/.muttr)2.5 E(c:)-.37 E F1 (Add these lines to your)108 448.8 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 (sour)108 460.8 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 -.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 398.4 S (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 (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) (email@w)-.18 E(ork.com")-.1 E(set mbox_type=Maildir)108 496.8 Q(set f)
108 422.4 Q(older=$HOME/Mail)-.25 E(set spool\214le=+P)108 434.4 Q 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 451.2 Q 2.5(si)-.55 G(t!)-2.5 E (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 468 Q(-IMAPD AND REFERENCES)-.37 E F0 .494 F1(UW)87 554.4 Q(-IMAPD AND REFERENCES)-.37 E F0 .494
(Some users with a UW)108 480 R .493(-IMAPD serv)-.65 F .493 (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 (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\ ("reference" feature to get at their mail-)2.993 F(box)108 578.4 Q .46(\
, specifying a reference of "~/Mail" or "#mh/" depending on the con\214\ es, specifying a reference of "~/Mail" or "#mh/" depending on the con\
guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)-2.96 E \214guration.)-.15 F .46(The belo)5.46 F 2.96(wc)-.25 G(on\214gura-)
.465(tion from docwhat@gerf.or)108 504 R 2.965(gs)-.18 G(ho)-2.965 E -2.96 E .465(tion from docwhat@gerf.or)108 590.4 R 2.965(gs)-.18 G(ho)
.465(ws using a reference of Mail, a nametrans that strips the leading \ -2.965 E .465(ws using a reference of Mail, a nametrans that strips the\
Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\214lter th\ leading Mail/ of)-.25 F(f)-.25 E(incoming folder names, and a folder\
at limits the folders synced to just three.)108 516 Q F1([Gerf])108 \214lter that limits the folders synced to just three.)108 602.4 Q F1
532.8 Q(localf)108 544.8 Q(olders = ~/Mail)-.25 E -.18(re)108 556.8 S ([Gerf])108 619.2 Q(localf)108 631.2 Q(olders = ~/Mail)-.25 E -.18(re)
(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 568.8 Q(es)-.1 E 108 643.2 S(motehost = gerf).18 E(.or)-.15 E(g)-.1 E(ssl = y)108 655.2 Q
-.18(re)108 580.8 S(moteuser = docwhat).18 E -.18(re)108 592.8 S(fer).18 (es)-.1 E -.18(re)108 667.2 S(moteuser = docwhat).18 E -.18(re)108 679.2
E(ence = Mail)-.18 E 2.5(#T)108 604.8 S(rims off the pr)-3.24 E S(fer).18 E(ence = Mail)-.18 E 2.5(#T)108 691.2 S(rims off the pr)-3.24
(eceeding Mail on all the f)-.18 E(older names.)-.25 E 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) (nametrans = lambda f)108 703.2 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 138 715.2 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 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) (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 .1 G(hough it)-2.5 E F0(John Goerzen)72 768 Q(July 12, 2002)151.655 E(3)
(ve t)-.1 H(hat r).1 E(efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E 201.915 E EP
-.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
%%Page: 4 4 %%Page: 4 4
%%BeginPageSetup %%BeginPageSetup
BP BP
%%EndPageSetup %%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R /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 (\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 SF 2.5(#w)108 84 S(ould seem intuiti)-2.6 E .2 -.1(ve t)-.1 H(hat r).1 E
100.8 Q(ORS)-.329 E F0(If you get one of some frequently-encountered or\ (efer)-.18 E(ence w)-.18 E(ould trim it.)-.1 E -.25(fo)108 96 S
confusing errors, please check this section.)108 112.8 Q F1(UID v)87 (lder\214lter = lambda f).25 E(older)-.25 E(name: f)-.15 E(older)-.25 E
129.6 Q(alidity pr)-.1 E(oblem f)-.18 E(or f)-.25 E(older)-.25 E F0 (name in [)-.15 E('Mail/INBO)125.5 108 Q(X',)-.4 E
1.637(IMAP serv)108 141.6 R 1.637 ('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 (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 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 (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 (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 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 .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(.) (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 194.4 R .108 -.55 E .108(Sometimes, the UIDs on the serv)108 278.4 R .108
(er might get reset.)-.15 F .108 (er might get reset.)-.15 F .108
(Usually this will happen if you delete and then recreate)5.108 F 3.742 (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 (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 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 (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 (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 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 (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) (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 .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 (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 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 288 Q(X)-.4 E F0 (rm ~/.of\215ineimap/AccountName/INBO)108 372 Q(X)-.4 E F0
(\(replacing AccountName with the account name as speci\214ed in)108 (\(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 .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 (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 (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 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) (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 -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 (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) (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) -.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 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 .27(ail, b)-2.77 F .27
(ut at the same time, it will not actually synchronize it either)-.2 F (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 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 F(dition and abort prior to synchronization\))108 482.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 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 439.2 R -.55(AQ)-.74 (UESTIONS)-.11 E F0 .683(There are some other F)108 523.2 R -.55(AQ)-.74
G 3.184(st).55 G .684 G 3.184(st).55 G .684
(hat might not \214t into another section of this document, and the) (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 -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\ F0(It should run on most platforms supported by Python, which are quite\
a fe)144 480 Q -.65(w.)-.25 G F1 .689 a fe)144 564 Q -.65(w.)-.25 G F1 .689
(I'm using Mutt. Other IMAP sync pr)108 496.8 R .689(ograms r)-.18 F (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 (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 (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 (Of\215ineIMAP)7.27 E F0 2.27
(is smart enough to \214gure out message deletion without this e)4.77 F (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 (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 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 F1(Of\215ineIMAP)6.05 E F0 1.05
(is smart enough to automatically \214gure out what folders are)3.55 F (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 -.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 (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\ (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 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 602.4 Q 2.5(wc)-.1 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 (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 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 F1 (lder\214lter).25 E F0(option in the con\214guration \214le.)2.5 E
(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
(John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP (John Goerzen)72 768 Q(July 12, 2002)151.655 E(4)201.915 E EP
%%Page: 5 5 %%Page: 5 5
%%BeginPageSetup %%BeginPageSetup
BP BP
%%EndPageSetup %%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R /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 (\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E/F1 10/Times-Bold@0
(.S)-.65 G(ee the e)-5 E(xample of)-.15 E SF(Ho)108 84 Q 2.5(wc)-.1 G(an I add or delete a f)-2.5 E(older?)-.25 E
(\215ineimap.conf \214le for details.)-.25 E/F1 10/Times-Bold@0 SF (Of\215ineIMAP)144 96 Q F0 .503(does not currently pro)3.003 F .504
(Can I synchr)108 100.8 Q(onize multiple accounts with Of\215ineIMAP?) (vide this feature, b)-.15 F .504(ut if you create a ne)-.2 F 3.004(wf)
-.18 E F0 3.345(Sure. Just)144 112.8 R .845(name them all in the accoun\ -.25 G .504(older on the IMAP)-3.004 F(serv)144 108 Q(er)-.15 E 2.5(,i)
ts line in the general section of the con\214g \214le, and add a)3.345 F -.4 G 2.5(tw)-2.5 G(ill be created locally automatically)-2.5 E(.)-.65 E
(per)144 124.8 Q(-account section for each one.)-.2 E F1 F1(Ar)108 124.8 Q 2.5(et)-.18 G(her)-2.5 E 2.5(ea)-.18 G(ny other war)
(Does Of\215ineIMAP support POP?)108 141.6 Q F0 4.076(No. POP)144 153.6 -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\ 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 (\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 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 194.4 R (ormats other than Maildir?)-.25 E F0 .41(Not at present.)144 300 R .41
.41(There is no technical reason not to; just no demand yet.)5.41 F .409 (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 (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 223.2 Q 2.5(ya)-.15 G .36 -.18 (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 (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.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 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 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 (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 (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 (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 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) (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 (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 (ving the name intact.)-.2 E(So,)144 417.6 Q F1(Of\215ineIMAP)3.2 E F0
(must store both a UID folder ID.)3.2 F .7 .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 (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 (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 (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 (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 352.8 (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 364.8 Q F0 -.15(ve)2.891 G 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 .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 (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\ 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 and maxconnections to 3 in each account clause.)144 482.4 Q .381
(This lets Of)144 393.6 R .381 (This lets Of)144 499.2 R .381
(\215ineIMAP open up multiple connections simultaneously)-.25 F 5.382 (\215ineIMAP open up multiple connections simultaneously)-.25 F 5.382
(.T)-.65 G .382(hat will let it process mul-)-5.382 F (.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 (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 (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 (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 F 2.632(saturated. Also,)144 540 R .132(too man)2.632 F 2.632(yc)-.15 G
G .132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F .132(onnections can cause mail serv)-2.632 F .132(ers to ha)-.15 F .433
.433 -.15(ve ex)-.2 H(cessi).15 E .433 -.15(ve l)-.25 H 2.633 -.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 (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 .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 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 (xperimentation may help.)-.15 E
(An informal benchmark yields these results for my setup:)144 475.2 Q (An informal benchmark yields these results for my setup:)144 580.8 Q
(10 minutes with MacOS X Mail.app "manual cache")144 492 Q 2.5(5m)144 (10 minutes with MacOS X Mail.app "manual cache")144 597.6 Q 2.5(5m)144
504 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 516 Q 609.6 S(inutes with GNUS agent sync)-2.5 E(20 seconds with Of)144 621.6
(\215ineIMAP 1.x)-.25 E 2.5(9s)144 528 S(econds with Of)-2.5 E 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 540 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 552 S(econds with Of) (\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 -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 (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> (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 -.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 (http://cr)144 715.2 Q(.yp.to/proto/maildir)-.55 E(.html.)-.55 E
<8353>108 626.4 S (John Goerzen)72 768 Q(July 12, 2002)151.655 E(5)201.915 E EP
(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
%%Page: 6 6 %%Page: 6 6
%%BeginPageSetup %%BeginPageSetup
BP BP
%%EndPageSetup %%EndPageSetup
/F0 10/Times-Roman@0 SF 111.22(OFFLINEIMAP\(1\) Of)72 48 R /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 (\215ineIMAP manual)-.25 E(OFFLINEIMAP\(1\))113.72 E 32.5<8353>108 84 S
SF(COPYING MESSA)87 84 Q(GES BETWEEN FOLDERS)-.55 E F0(Normally)108 96 Q (tandard Python 2.2.1 as implemented on POSIX-compliant systems.)-32.5 E
5.858(,w)-.65 G 3.358(hen you cop)-5.858 F -8.357 5.858(ya m)-.1 H 3.359 /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 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 (essage to a folder locally)-5.859 F(,)-.65 E F2(Of\215ineIMAP)108 225.6
F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E -.15 Q F0 .853(will just do the right thing.)3.353 F(Ho)5.853 E(we)-.25 E
(ve)-.25 G 1.653 -.4(r, s).15 H .853(ometimes this can be trick).4 F -.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(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 -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 F1 (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 (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 (mine the ne)108 249.6 R 2.674(wU)-.25 G .174(ID of the message.)-2.674
.173(So, in these rare instances, Of)5.173 F .173 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 (\215ineIMAP will upload the message to the)-.25 F .64(IMAP serv)108
R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55 G .64 261.6 R .64(er and delete it from your local folder)-.15 F 5.64(.T)-.55
(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)-.15 F G .64(hen, on your ne)-5.64 F .64(xt sync, the message will be re-do)
(wn-)-.25 E 1.473(loaded with the proper UID.)108 156 R F1 -.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) (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 -.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 (deleting it, so there should be no risk of data loss.)108 285.6 Q F2
(MAILING LIST)87 184.8 Q F0(There is an Of)108 196.8 Q (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 (\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 (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 (\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 (post, send the message to of)108 343.2 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 (g.)-.18 E F1 -.11(BU)72 360 S(GS).11 E F0 4.42(Reports of b)108 372 R
(Reports of b)108 254.4 R 4.419(ugs should be sent via e-mail to the)-.2 4.419(ugs should be sent via e-mail to the)-.2 F F2(Of\215ineIMAP)6.919
F F1(Of\215ineIMAP)6.919 E F0 -.2(bu)6.919 G 4.419 E F0 -.2(bu)6.919 G 4.419(g-tracking system \(BTS\) at).2 F(of)108 384 Q
(g-tracking system \(BTS\) at).2 F(of)108 266.4 Q(\215ineimap@b)-.25 E (\215ineimap@b)-.25 E(ugs.complete.or)-.2 E 3.396(go)-.18 G 3.396(rs)
(ugs.complete.or)-.2 E 3.396(go)-.18 G 3.396(rs)-3.396 G .897 -3.396 G .897(ubmitted on-line using the W)-3.396 F .897(eb interf)-.8 F
(ubmitted on-line using the W)-3.396 F .897(eb interf)-.8 F .897 .897(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108
(ace at http://b)-.1 F(ugs.complete.or)-.2 E(g/.)-.18 E(The W)108 278.4 396 Q(eb site also lists all current b)-.8 E
Q(eb site also lists all current b)-.8 E
(ugs, where you can check their status or contrib)-.2 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 (\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 (This program is free softw)108 441.6 R .287(are; you can redistrib)-.1
.286(ute it and/or modify it under the terms of the GNU General)-.2 F 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) .766(Public License as published by the Free Softw)108 453.6 R .766
-.1 F .766(oundation; either v)-.15 F .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 (ersion 2 of the License, or \(at your)-.15 F(option\) an)108 465.6 Q
(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib)108 2.5(yl)-.15 G(ater v)-2.5 E(ersion.)-.15 E .58(This program is distrib)
364.8 R .579(uted in the hope that it will be useful, b)-.2 F .579 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 (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 .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 (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) (the GNU General Public License for more details.)108 506.4 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) 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) .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 -2.77 G .27
(he GNU General Public License along with this program; if not, write) (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 -2.77 F(to:)108 535.2 Q(Free Softw)108 552 Q(are F)-.1 E
(oundation, Inc.)-.15 E(59 T)108 446.4 Q(emple Place)-.7 E(Suite 330)108 (oundation, Inc.)-.15 E(59 T)108 564 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 576 Q(Boston, MA)108 588 Q(02111-1307)5 E(USA)108 600 Q F1 -.548(AU)72
(AU)72 499.2 S(THOR).548 E F1(Of\215ineIMAP)108 511.2 Q(,)-.92 E F0 .488 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 (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 (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 (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 540 Q (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\ (\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 (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 (http://quux.or)108 686.4 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 (\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 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 (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 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 (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) 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 609.6 Q -.15(ve)-.15 G -3.218 F(\215ineIMAP)-.25 E(with Sub)108 727.2 Q -.15(ve)-.15 G
(rsion, please visit:).15 E(http://svn.complete.or)108 626.4 Q(g/)-.18 E (rsion, please visit:).15 E(John Goerzen)72 768 Q(July 12, 2002)151.655
F2(SEE ALSO)72 643.2 Q F1(mutt)108 655.2 Q F0(\(1\),)A F1(python)2.5 E E(6)201.915 E EP
F0(\(1\).)A(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 %%Trailer
end end
%%EOF %%EOF

View File

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

View File

@ -23,12 +23,15 @@ OfflineIMAP \- Powerful IMAP/Maildir synchronization and reader support
.BI \-1 .BI \-1
] ]
[ [
.BI \-P \ profiledir
]
[
.BI \-a \ accountlist .BI \-a \ accountlist
] ]
[ [
.BI \-c \ configfile .BI \-c \ configfile
] ]
.br .\".br
[ [
.BI \-d .BI \-d
] ]
@ -217,6 +220,22 @@ sync. This effectively sets the
and all and all
.B maxconnections .B maxconnections
configuration file variables to 1. 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 .TP
.BI \-a \ accountlist .BI \-a \ accountlist
Overrides the Overrides the

View File

@ -29,7 +29,7 @@ if '--help' in sys.argv[1:]:
sys.stdout.write(version.cmdhelp + "\n") sys.stdout.write(version.cmdhelp + "\n")
sys.exit(0) 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] options[optlist[0]] = optlist[1]
if '-d' in options: if '-d' in options:
@ -41,6 +41,15 @@ if '-h' in options:
configfilename = os.path.expanduser("~/.offlineimaprc") configfilename = os.path.expanduser("~/.offlineimaprc")
if '-c' in options: if '-c' in options:
configfilename = options['-c'] 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() config = ConfigParser()

View File

@ -18,7 +18,13 @@
from threading import * from threading import *
from StringIO import StringIO from StringIO import StringIO
import sys, traceback, thread import sys, traceback, thread, profile
profiledir = None
def setprofiledir(newdir):
global profiledir
profiledir = newdir
###################################################################### ######################################################################
# General utilities # General utilities
@ -81,10 +87,20 @@ class ExitNotifyThread(Thread):
"""This class is designed to alert a "monitor" to the fact that a thread has """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.""" exited and to provide for the ability for it to find out why."""
def run(self): def run(self):
global exitcondition, exitthreads global exitcondition, exitthreads, profiledir
self.threadid = thread.get_ident() self.threadid = thread.get_ident()
try: 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: except:
self.setExitCause('EXCEPTION') self.setExitCause('EXCEPTION')
self.setExitException(sys.exc_info()[1]) self.setExitException(sys.exc_info()[1])

View File

@ -1,8 +1,8 @@
productname = 'OfflineIMAP' productname = 'OfflineIMAP'
versionstr = "3.0.3" versionstr = "3.0.3"
revno = long('$Rev: 152 $'[6:-2]) revno = long('$Rev: 164 $'[6:-2])
revstr = "Rev %d" % revno 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(".") 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""" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA"""
cmdhelp = """ cmdhelp = """
offlineimap [ -1 ] [ -a accountlist ] [ -c configfile ] offlineimap [ -1 ] [ -P profiledir ] [ -a accountlist ] [
[ -d ] [ -u interface ] -c configfile ] [ -d ] [ -o ] [ -u interface ]
offlineimap -h | --help 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 solely a single-thread sync. This effectively sets
the maxsyncaccounts and all maxconnections configu- the maxsyncaccounts and all maxconnections configu-
ration file variables to 1. 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 -a accountlist
Overrides the accounts section in the config file. Overrides the accounts section in the config file.
Lets you specify a particular account or set of Lets you specify a particular account or set of
@ -72,14 +85,23 @@ cmdhelp = """
remove that from the debugging output before send- remove that from the debugging output before send-
ing it to anyone else. ing it to anyone else.
-o Run only once, ignoring any autorefresh setting in
the config file.
-h, --help -h, --help
Show summary of options. Show summary of options.
-u interface -u interface
Specifies an alternative user interface module to Specifies an alternative user interface module to
use. This overrides the default specified in the use. This overrides the default specified in the
configuration file. The UI specified with -u will configuration file. The UI specified with -u will
be forced to be used, even if its isuable() method be forced to be used, even if its isuable() method
states that it cannot be. Use this option with states that it cannot be. Use this option with
care. 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).
""" """