From b8f1c9c4c37cd3e361a273dea77acdd6e23cc1b8 Mon Sep 17 00:00:00 2001
From: Leif Madsen <leif@leifmadsen.com>
Date: Wed, 5 Aug 2009 18:49:58 +0000
Subject: [PATCH] Merged revisions 210563 via svnmerge from
https://origsvn.digium.com/svn/asterisk/branches/1.4
........
r210563 | lmadsen | 2009-08-05 13:46:21 -0500 (Wed, 05 Aug 2009) | 11 lines
Update imapstorage.txt documentation.
Updated the imapstorage.txt documentation to reflect that issues with
c-client versions older than 2007 seem to cause crashing issues that
are not seen with more recent versions. Documentation has been updated
to reflect this.
(closes issue #14496)
Reported by: vbcrlfuser
Patches:
__20090727-imap-documentation-patch.txt uploaded by lmadsen (license 10)
Tested by: lmadsen, mmichelson, dbrooks
........
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@210564 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
doc/tex/imapstorage.tex | 23 +++++++++++++++++------
1 file changed, 17 insertions(+), 6 deletions(-)
diff --git a/doc/tex/imapstorage.tex b/doc/tex/imapstorage.tex
index 608a39fbb6..75663e928f 100644
--- a/doc/tex/imapstorage.tex
+++ b/doc/tex/imapstorage.tex
@@ -22,8 +22,11 @@ additional voicemail functionality, including:
If you do not have the University of Washington's IMAP c-client
installed on your system, you will need to download the c-client
source distribution (\url{http://www.washington.edu/imap/}) and compile it.
-Asterisk supports both the 2004 and 2006 versions of c-client, however
-mail\_expunge\_full is enabled in the 2006 version.
+Asterisk supports the 2007 version of c-client as there appears to be issues
+with older versions which cause Asterisk to crash in certain scenarios. It
+is highly recommended that you utilize a current version of the c-client
+libraries. Additionally, mail\_expunge\_full is enabled in the 2006 and later
+versions.
Note that Asterisk only uses the 'c-client' portion of the UW IMAP toolkit,
but building it also builds an IMAP server and various other utilities.
@@ -41,7 +44,7 @@ Debian system there are two possibilities:
\begin{enumerate}
\item If you will not be using SSL to connect to the IMAP server:
\begin{verbatim}
- $ make slx SSLTYPE=none!
+ $ make slx SSLTYPE=none
\end{verbatim}
\item If you will be using SSL to connect to the IMAP server:
\begin{verbatim}
@@ -55,14 +58,14 @@ need to run 'make install'.
\subsubsection{Compiling Asterisk}
Configure with ./configure --with-imap=/usr/src/imap
-or where ever you built thfe UWashington IMAP Toolkit. This directory
+or wherever you built the UWashington IMAP Toolkit. This directory
will be searched for a source installation. If no source installation is
found there, then a package installation of the IMAP c-client will be
searched for in this directory. If one is not found, then configure will fail.
A second configure option is to not specify a directory (i.e.
./configure --with-imap). This will assume that you have the
-imap-2004g source installed in the .. directory relative to the
+imap-2007e source installed in the ../imap directory relative to the
Asterisk source. If you do not have this source, then configure will
default to the "system" option defined in the next paragraph
@@ -164,7 +167,9 @@ UIDPLUS is currently NOT supported on these versions of UW-IMAP. Please note
that without UID\_EXPUNGE, Asterisk voicemail will expunge ALL messages marked
for deletion when a user exits the voicemail system (hangs up the phone).
-\subsubsection{UW IMAP-2006 Development Branch}
+This version is *not* recommended for Asterisk.
+
+\subsubsection{UW IMAP-2006}
This version supports UIDPLUS, which allows UID\_EXPUNGE capabilities. This
feature allow the system to expunge ONLY pertinent messages, instead of the
@@ -173,6 +178,12 @@ EXPUNGE is called. The IMAP storage mechanism is this version of Asterisk
will check if the UID\_EXPUNGE feature is supported by the server, and use it
if possible.
+This version is *not* recommended for Asterisk.
+
+\subsubsection{UW IMAP-2007}
+
+This is the currently recommended version for use with Asterisk.
+
\subsubsection{Cyrus IMAP}
Cyrus IMAP server v2.3.3 has been tested using a hierarchy delimiter of '/'.
--
GitLab