@ -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 e ver you built thf e 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 '/'.