/usr/share/doc/vm/html/IMAP-Server-Folders.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>VM User&rsquo;s Manual: IMAP Server Folders</title>

<meta name="description" content="VM User&rsquo;s Manual: IMAP Server Folders">
<meta name="keywords" content="VM User&rsquo;s Manual: IMAP Server Folders">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="License.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Frames-and-Windows.html#Frames-and-Windows" rel="next" title="Frames and Windows">
<link href="Virtual-Folders.html#vm_002davirtual" rel="prev" title="vm-avirtual">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="IMAP-Server-Folders"></a>
<div class="header">
<p>
Next: <a href="Frames-and-Windows.html#Frames-and-Windows" accesskey="n" rel="next">Frames and Windows</a>, Previous: <a href="Virtual-Folders.html#Virtual-Folders" accesskey="p" rel="prev">Virtual Folders</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="License.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="IMAP-Server-Folders-1"></a>
<h2 class="chapter">14 <acronym>IMAP</acronym> Server Folders</h2>

<p>This chapter covers the additional features of <acronym>IMAP</acronym> server
folders, i.e., folders on an <acronym>IMAP</acronym> server that you access using VM.
See <a href="Starting-Up.html#IMAP-Folders"><acronym>IMAP</acronym> Folders</a>.  Do not use these features if you just
download mail from IMAP mail boxes into local folders.
</p>
<a name="index-vm_002dimap_002dsynchronize-1"></a>
<p>The command <code>vm-imap-synchronize</code> can be used to perform full
synchronization between a VM folder and the corresponding folder on the IMAP
server.  (Recall that <code>vm-get-new-mail</code> and <code>vm-save-folder</code> do
half-synchronization in one direction each.)
</p>
<a name="index-vm_002dimap_002dconnection_002dmode"></a>
<p>The variable <code>vm-imap-connection-mode</code> allows you to work while
disconnected from the network.  If it is set to <code>online</code>, which is the
default, VM communicates with the server during <code>vm-get-new-mail</code>,
<code>vm-save-folder</code> and <code>vm-imap-synchronize</code> operations.  In order
to work while disconnected from the network, set the variable to
<code>offline</code>.  In this mode, <code>vm-save-folder</code> writes any changes
made to the folder to the local copy on disk (the &ldquo;cache&rdquo; folder);
<code>vm-visit-imap-folder</code> likewise visits the cache folder.
</p>
<p>You can set <code>vm-imap-connection-mode</code> to <code>autoconnect</code> if you have
intermittent problems with the network.  In this mode, doing
<code>vm-get-new-mail</code> attempts to connect to the network.  If it succeeds
then <code>vm-imap-connection-mode</code> turns into <code>online</code>.
</p>
<p>When the <acronym>IMAP</acronym> server is connected again, you should run <kbd>C-u
M-x vm-imap-synchronize</kbd>, i.e., call it with a <em>prefix argument</em>.  This
causes <em>all</em> the message attributes and labels to be written to the
server, since it may not be known which of them have actually changed during
the offline operation.  Similarly, <em>all</em> the messages that may have
been expunged in the cache folder are expunged on the server.
</p>
<a name="UIDVALIDITY"></a><a name="UIDVALIDITY-1"></a>
<h3 class="unnumberedsec"><acronym>UIDVALIDITY</acronym></h3>

<a name="index-UIDVALIDITY"></a>
<p>Messages on an <acronym>IMAP</acronym> server have unique id numbers called UID&rsquo;s.
In addition, a second id number called <em><acronym>UIDVALIDITY</acronym></em> allows
the server to renumber messages when the id numbers within a particular
<acronym>UIDVALIDITY</acronym> are exhausted.  All the messages on the server at any
given time have the same <acronym>UIDVALIDITY</acronym> value.  When the server needs
to renumber the messages, it changes the <acronym>UIDVALIDITY</acronym> value and
issues new <acronym>UID</acronym> numbers for all the messages with new
<acronym>UIDVALIDITY</acronym>.  This happens but rarely because there are over two
billion UID&rsquo;s within each <acronym>UIDVALIDITY</acronym>.
</p>
<p>When the <acronym>UIDVALIDITY</acronym> changes on the <acronym>IMAP</acronym> server, VM has
no easy way to identify the new UID&rsquo;s for the messages in its cache.  So, it
marks all the messages in the cache as invalid and refreshes the cache with
new copies of messages from the server.  This is a time-consuming operation
but it happens only rarely.  VM warns you before it refreshes the cache and
asks for confirmation.  You can abort the operation if you cannot spare the
time, but note that it is not possible to perform any changes to the
<acronym>IMAP</acronym> folder until the cache is refreshed.  You might consider
setting the <code>vm-enable-external-messages</code> flag to <code>(imap)</code> before
you refresh the cache so that it will be quicker. see <a href="Starting-Up.html#External-Messages">External Messages</a>.
</p>
<a name="Operations-for-the-IMAP-server"></a>
<h4 class="unnumberedsubsec">Operations for the IMAP server</h4>

<a name="index-vm_002dlist_002dimap_002dfolders"></a>
<p>The command <code>vm-list-imap-folders</code> lists the folders available on the
<acronym>IMAP</acronym> server, along with the total number of messages and recent
(new) messages in each of them.  If you run it with a prefix argument, it
lists only those folders that have new messages.
</p>
<a name="index-vm_002dcreate_002dimap_002dfolder"></a>
<a name="index-vm_002ddelete_002dimap_002dfolder"></a>
<a name="index-vm_002drename_002dimap_002dfolder"></a>
<p>Use the command <code>vm-create-imap-folder</code> for creating a new folder on
the <acronym>IMAP</acronym> server and <code>vm-delete-imap-folder</code> for deleting an
existing folder.  You can rename a folder using
<code>vm-rename-imap-folder</code>.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Frames-and-Windows.html#Frames-and-Windows" accesskey="n" rel="next">Frames and Windows</a>, Previous: <a href="Virtual-Folders.html#Virtual-Folders" accesskey="p" rel="prev">Virtual Folders</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="License.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
vm 8.2.0b-2 / usr / share / doc / vm / html / IMAP-Server-Folders.html
