kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-14 16:33:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merged revisions 210563 via svnmerge from

Browse Source 
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
This commit is contained in:
Leif Madsen
2009-08-05 18:49:58 +00:00
parent 3b91d3b5ab
commit b8f1c9c4c3
1 changed files with 17 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
doc/tex/imapstorage.tex
View File

@@ -22,8 +22,11 @@ additional voicemail functionality, including:
If you do not have the University of Washington's IMAP c-client 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 installed on your system, you will need to download the c-client
source distribution (\url{http://www.washington.edu/imap/}) and compile it. source distribution (\url{http://www.washington.edu/imap/}) and compile it.
Asterisk supports both the 2004 and 2006 versions of c-client, however Asterisk supports the 2007 version of c-client as there appears to be issues
mail\_expunge\_full is enabled in the 2006 version. 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, 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. but building it also builds an IMAP server and various other utilities.
@@ -41,7 +44,7 @@ Debian system there are two possibilities:
\begin{enumerate} \begin{enumerate}
\item If you will not be using SSL to connect to the IMAP server: \item If you will not be using SSL to connect to the IMAP server:
\begin{verbatim} \begin{verbatim}
$ make slx SSLTYPE=none! $ make slx SSLTYPE=none
\end{verbatim} \end{verbatim}
\item If you will be using SSL to connect to the IMAP server: \item If you will be using SSL to connect to the IMAP server:
\begin{verbatim} \begin{verbatim}
@@ -55,14 +58,14 @@ need to run 'make install'.
\subsubsection{Compiling Asterisk} \subsubsection{Compiling Asterisk}
Configure with ./configure --with-imap=/usr/src/imap 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 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 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. 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. A second configure option is to not specify a directory (i.e.
./configure --with-imap). This will assume that you have the ./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 Asterisk source. If you do not have this source, then configure will
default to the "system" option defined in the next paragraph 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 that without UID\_EXPUNGE, Asterisk voicemail will expunge ALL messages marked
for deletion when a user exits the voicemail system (hangs up the phone). 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 This version supports UIDPLUS, which allows UID\_EXPUNGE capabilities. This
feature allow the system to expunge ONLY pertinent messages, instead of the 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 will check if the UID\_EXPUNGE feature is supported by the server, and use it
if possible. 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} \subsubsection{Cyrus IMAP}
Cyrus IMAP server v2.3.3 has been tested using a hierarchy delimiter of '/'. Cyrus IMAP server v2.3.3 has been tested using a hierarchy delimiter of '/'.