claws-mail/src/ldapserver.c
Paul Mangan 4afa1432ff 2006-01-13 [paul] 1.9.100cvs142
* src/account.c
	* src/account.h
	* src/action.c
	* src/action.h
	* src/adbookbase.h
	* src/addr_compl.c
	* src/addr_compl.h
	* src/addrbook.c
	* src/addrcache.c
	* src/addrcache.h
	* src/addrcindex.c
	* src/addrcindex.h
	* src/addrclip.c
	* src/addrclip.h
	* src/addrdefs.h
	* src/addressadd.c
	* src/addressadd.h
	* src/addressbook.c
	* src/addressbook.h
	* src/addrgather.c
	* src/addrgather.h
	* src/addrharvest.c
	* src/addrharvest.h
	* src/addrindex.c
	* src/addrindex.h
	* src/addritem.c
	* src/addritem.h
	* src/addrquery.c
	* src/addrquery.h
	* src/addrselect.c
	* src/addrselect.h
	* src/alertpanel.c
	* src/alertpanel.h
	* src/browseldap.c
	* src/browseldap.h
	* src/codeconv.c
	* src/codeconv.h
	* src/compose.c
	* src/compose.h
	* src/customheader.c
	* src/customheader.h
	* src/displayheader.c
	* src/displayheader.h
	* src/editaddress.c
	* src/editaddress.h
	* src/editbook.c
	* src/editbook.h
	* src/editgroup.c
	* src/editgroup.h
	* src/editjpilot.c
	* src/editjpilot.h
	* src/editldap.c
	* src/editldap.h
	* src/editldap_basedn.c
	* src/editldap_basedn.h
	* src/editvcard.c
	* src/editvcard.h
	* src/exphtmldlg.c
	* src/exphtmldlg.h
	* src/expldifdlg.c
	* src/expldifdlg.h
	* src/export.h
	* src/exporthtml.c
	* src/exporthtml.h
	* src/exportldif.c
	* src/exportldif.h
	* src/filtering.c
	* src/filtering.h
	* src/folder.c
	* src/folder.h
	* src/folder_item_prefs.c
	* src/folder_item_prefs.h
	* src/foldersel.c
	* src/foldersel.h
	* src/folderutils.c
	* src/folderutils.h
	* src/folderview.c
	* src/folderview.h
	* src/grouplistdialog.c
	* src/grouplistdialog.h
	* src/headerview.c
	* src/html.c
	* src/html.h
	* src/image_viewer.c
	* src/image_viewer.h
	* src/imap.c
	* src/imap.h
	* src/imap_gtk.c
	* src/imap_gtk.h
	* src/import.h
	* src/importldif.c
	* src/importldif.h
	* src/importmutt.c
	* src/importmutt.h
	* src/importpine.c
	* src/importpine.h
	* src/inc.c
	* src/inc.h
	* src/jpilot.c
	* src/jpilot.h
	* src/ldapctrl.c
	* src/ldapctrl.h
	* src/ldaplocate.c
	* src/ldaplocate.h
	* src/ldapquery.c
	* src/ldapquery.h
	* src/ldapserver.c
	* src/ldapserver.h
	* src/ldaputil.c
	* src/ldaputil.h
	* src/ldif.c
	* src/ldif.h
	* src/main.c
	* src/main.h
	* src/mainwindow.c
	* src/mainwindow.h
	* src/manual.c
	* src/manual.h
	* src/mbox.c
	* src/mbox.h
	* src/message_search.c
	* src/message_search.h
	* src/messageview.c
	* src/messageview.h
	* src/mh.c
	* src/mh.h
	* src/mh_gtk.c
	* src/mh_gtk.h
	* src/mimeview.c
	* src/mimeview.h
	* src/msgcache.c
	* src/msgcache.h
	* src/mutt.c
	* src/mutt.h
	* src/news.c
	* src/news.h
	* src/news_gtk.c
	* src/news_gtk.h
	* src/partial_download.c
	* src/partial_download.h
	* src/pine.c
	* src/pine.h
	* src/pop.c
	* src/pop.h
	* src/prefs_account.c
	* src/prefs_account.h
	* src/prefs_actions.c
	* src/prefs_actions.h
	* src/prefs_common.c
	* src/prefs_common.h
	* src/prefs_compose_writing.c
	* src/prefs_compose_writing.h
	* src/prefs_customheader.c
	* src/prefs_customheader.h
	* src/prefs_display_header.c
	* src/prefs_display_header.h
	* src/prefs_filtering.c
	* src/prefs_filtering.h
	* src/prefs_filtering_action.c
	* src/prefs_filtering_action.h
	* src/prefs_folder_column.c
	* src/prefs_folder_column.h
	* src/prefs_folder_item.c
	* src/prefs_folder_item.h
	* src/prefs_fonts.c
	* src/prefs_fonts.h
	* src/prefs_gtk.c
	* src/prefs_gtk.h
	* src/prefs_image_viewer.c
	* src/prefs_image_viewer.h
	* src/prefs_matcher.c
	* src/prefs_matcher.h
	* src/prefs_message.c
	* src/prefs_msg_colors.c
	* src/prefs_msg_colors.h
	* src/prefs_other.c
	* src/prefs_quote.c
	* src/prefs_receive.c
	* src/prefs_send.c
	* src/prefs_spelling.c
	* src/prefs_spelling.h
	* src/prefs_summaries.c
	* src/prefs_summaries.h
	* src/prefs_summary_column.c
	* src/prefs_summary_column.h
	* src/prefs_template.c
	* src/prefs_template.h
	* src/prefs_themes.c
	* src/prefs_themes.h
	* src/prefs_toolbar.c
	* src/prefs_toolbar.h
	* src/prefs_wrapping.c
	* src/prefs_wrapping.h
	* src/privacy.c
	* src/privacy.h
	* src/procheader.c
	* src/procheader.h
	* src/procmime.c
	* src/procmime.h
	* src/procmsg.c
	* src/procmsg.h
	* src/quote_fmt.c
	* src/quote_fmt_parse.y
	* src/recv.c
	* src/recv.h
	* src/remotefolder.c
	* src/remotefolder.h
	* src/send_message.c
	* src/send_message.h
	* src/setup.c
	* src/setup.h
	* src/sourcewindow.c
	* src/sourcewindow.h
	* src/ssl_manager.c
	* src/ssl_manager.h
	* src/statusbar.c
	* src/statusbar.h
	* src/stock_pixmap.c
	* src/stock_pixmap.h
	* src/summary_search.c
	* src/summary_search.h
	* src/summaryview.c
	* src/summaryview.h
	* src/syldap.c
	* src/syldap.h
	* src/textview.c
	* src/textview.h
	* src/toolbar.c
	* src/toolbar.h
	* src/undo.c
	* src/undo.h
	* src/unmime.c
	* src/unmime.h
	* src/vcard.c
	* src/vcard.h
	* src/wizard.c
	* src/wizard.h
	* src/common/base64.c
	* src/common/base64.h
	* src/common/defs.h
	* src/common/hooks.c
	* src/common/hooks.h
	* src/common/log.c
	* src/common/log.h
	* src/common/mgutils.c
	* src/common/mgutils.h
	* src/common/nntp.c
	* src/common/nntp.h
	* src/common/passcrypt.c
	* src/common/passcrypt.h.in
	* src/common/plugin.c
	* src/common/plugin.h
	* src/common/prefs.c
	* src/common/prefs.h
	* src/common/progressindicator.c
	* src/common/progressindicator.h
	* src/common/quoted-printable.c
	* src/common/quoted-printable.h
	* src/common/session.c
	* src/common/session.h
	* src/common/smtp.c
	* src/common/smtp.h
	* src/common/socket.c
	* src/common/socket.h
	* src/common/ssl.c
	* src/common/ssl.h
	* src/common/ssl_certificate.c
	* src/common/ssl_certificate.h
	* src/common/stringtable.c
	* src/common/stringtable.h
	* src/common/sylpheed.c
	* src/common/sylpheed.h
	* src/common/template.c
	* src/common/template.h
	* src/common/timing.h
	* src/common/utils.c
	* src/common/utils.h
	* src/common/version.h.in
	* src/common/xml.c
	* src/common/xml.h
	* src/common/xmlprops.c
	* src/common/xmlprops.h
	* src/gtk/colorlabel.c
	* src/gtk/colorsel.c
	* src/gtk/colorsel.h
	* src/gtk/description_window.c
	* src/gtk/description_window.h
	* src/gtk/filesel.c
	* src/gtk/filesel.h
	* src/gtk/foldersort.c
	* src/gtk/foldersort.h
	* src/gtk/gtkutils.c
	* src/gtk/gtkutils.h
	* src/gtk/inputdialog.c
	* src/gtk/inputdialog.h
	* src/gtk/logwindow.c
	* src/gtk/logwindow.h
	* src/gtk/manage_window.c
	* src/gtk/manage_window.h
	* src/gtk/menu.c
	* src/gtk/menu.h
	* src/gtk/pluginwindow.c
	* src/gtk/pluginwindow.h
	* src/gtk/prefswindow.c
	* src/gtk/prefswindow.h
	* src/gtk/progressdialog.c
	* src/gtk/progressdialog.h
	* src/gtk/sslcertwindow.c
	* src/gtk/sslcertwindow.h
	* src/plugins/clamav/clamav_plugin.c
	* src/plugins/clamav/clamav_plugin.h
	* src/plugins/clamav/clamav_plugin_gtk.c
	* src/plugins/demo/demo.c
	* src/plugins/dillo_viewer/dillo_prefs.c
	* src/plugins/dillo_viewer/dillo_prefs.h
	* src/plugins/dillo_viewer/dillo_viewer.c
	* src/plugins/pgpcore/passphrase.c
	* src/plugins/pgpcore/passphrase.h
	* src/plugins/pgpcore/plugin.c
	* src/plugins/pgpcore/select-keys.c
	* src/plugins/pgpcore/select-keys.h
	* src/plugins/pgpcore/sgpgme.c
	* src/plugins/pgpcore/sgpgme.h
	* src/plugins/pgpinline/pgpinline.c
	* src/plugins/pgpinline/pgpinline.h
	* src/plugins/pgpinline/plugin.c
	* src/plugins/pgpmime/pgpmime.c
	* src/plugins/pgpmime/pgpmime.h
	* src/plugins/pgpmime/plugin.c
	* src/plugins/spamassassin/spamassassin.c
	* src/plugins/spamassassin/spamassassin.h
	* src/plugins/spamassassin/spamassassin_gtk.c
	* src/plugins/trayicon/trayicon.c
		update copyright header
2006-01-13 17:24:38 +00:00

703 lines
18 KiB
C

/*
* Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
* Copyright (C) 2003-2006 Match Grun and the Sylpheed-Claws team
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/*
* Functions necessary to access LDAP servers.
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
#ifdef USE_LDAP
#include <glib.h>
#include <sys/time.h>
#include <string.h>
#include <ldap.h>
#include <lber.h>
#include "mgutils.h"
#include "addritem.h"
#include "addrcache.h"
#include "ldapctrl.h"
#include "ldapquery.h"
#include "ldapserver.h"
#include "utils.h"
#include "adbookbase.h"
/**
* Create new LDAP server interface object with no control object.
* \return Initialized LDAP server object.
*/
LdapServer *ldapsvr_create_noctl( void ) {
LdapServer *server;
server = g_new0( LdapServer, 1 );
server->type = ADBOOKTYPE_LDAP;
server->addressCache = addrcache_create();
server->retVal = MGU_SUCCESS;
server->control = NULL;
server->listQuery = NULL;
server->searchFlag = FALSE;
return server;
}
/**
* Create new LDAP server interface object.
* \return Initialized LDAP server object.
*/
LdapServer *ldapsvr_create( void ) {
LdapServer *server;
server = ldapsvr_create_noctl();
server->control = ldapctl_create();
return server;
}
/**
* Return name of server.
* \param server Server object.
* \return Name for server.
*/
gchar *ldapsvr_get_name( LdapServer *server ) {
g_return_val_if_fail( server != NULL, NULL );
return addrcache_get_name( server->addressCache );
}
/**
* Specify name to be used.
* \param server Server object.
* \param value Name for server.
*/
void ldapsvr_set_name( LdapServer* server, const gchar *value ) {
g_return_if_fail( server != NULL );
addrcache_set_name( server->addressCache, value );
}
/**
* Refresh internal variables to force a file read.
* \param server Server object.
*/
void ldapsvr_force_refresh( LdapServer *server ) {
addrcache_refresh( server->addressCache );
}
/**
* Return status/error code.
* \param server Server object.
* \return Status/error code.
*/
gint ldapsvr_get_status( LdapServer *server ) {
g_return_val_if_fail( server != NULL, -1 );
return server->retVal;
}
/**
* Return reference to root level folder.
* \param server Server object.
* \return Root level folder.
*/
ItemFolder *ldapsvr_get_root_folder( LdapServer *server ) {
g_return_val_if_fail( server != NULL, NULL );
/*
printf( "ldapsvr_get_root_folder/start\n" );
ldapsvr_print_data( server, stdout );
printf( "ldapsvr_get_root_folder/done\n" );
*/
return addrcache_get_root_folder( server->addressCache );
}
/**
* Test whether server data has been accessed.
* \param server Server object.
* \return <i>TRUE</i> if data was accessed.
*/
gboolean ldapsvr_get_accessed( LdapServer *server ) {
g_return_val_if_fail( server != NULL, FALSE );
return server->addressCache->accessFlag;
}
/**
* Specify that server's data whas beed accessed.
* \param server Server object.
* \param value Value for flag.
*/
void ldapsvr_set_accessed( LdapServer *server, const gboolean value ) {
g_return_if_fail( server != NULL );
server->addressCache->accessFlag = value;
}
/**
* Test whether server data has been modified.
* \param server Server object.
* \return <i>TRUE</i> if data was modified.
*/
gboolean ldapsvr_get_modified( LdapServer *server ) {
g_return_val_if_fail( server != NULL, FALSE );
return server->addressCache->modified;
}
/**
* Specify modify flag.
* \param server Server object.
* \param value Value for flag.
*/
void ldapsvr_set_modified( LdapServer *server, const gboolean value ) {
g_return_if_fail( server != NULL );
server->addressCache->modified = value;
}
/**
* Test whether data was read from server.
* \param server Server object.
* \return <i>TRUE</i> if data was read.
*/
gboolean ldapsvr_get_read_flag( LdapServer *server ) {
g_return_val_if_fail( server != NULL, FALSE );
return server->addressCache->dataRead;
}
/**
* Test whether server is to be used for dynamic searches.
* \param server Server object.
* \return <i>TRUE</i> if server is used for dynamic searches.
*/
gboolean ldapsvr_get_search_flag( LdapServer *server ) {
g_return_val_if_fail( server != NULL, FALSE );
return server->searchFlag;
}
/**
* Specify that server is to be used for dynamic searches.
* \param server Server object.
* \param value Name for server.
*/
void ldapsvr_set_search_flag( LdapServer *server, const gboolean value ) {
g_return_if_fail( server != NULL );
server->searchFlag = value;
}
/**
* Specify the reference to control data that will be used for the query. The calling
* module should be responsible for creating and destroying this control object.
* \param server Server object.
* \param ctl Control data.
*/
void ldapsvr_set_control( LdapServer *server, LdapControl *ctl ) {
g_return_if_fail( server != NULL );
addrcache_refresh( server->addressCache );
server->control = ctl;
}
/**
* Free all queries.
* \param server Server object.
*/
void ldapsvr_free_all_query( LdapServer *server ) {
GList *node;
g_return_if_fail( server != NULL );
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
ldapqry_free( qry );
node->data = NULL;
node = g_list_next( node );
}
g_list_free( server->listQuery );
server->listQuery = NULL;
}
/**
* Add query to server.
* \param server Server object.
* \param qry Query object.
*/
void ldapsvr_add_query( LdapServer *server, LdapQuery *qry ) {
g_return_if_fail( server != NULL );
g_return_if_fail( qry != NULL );
server->listQuery = g_list_append( server->listQuery, qry );
qry->server = server;
}
/**
* Free up LDAP server interface object by releasing internal memory.
* \param server Server object.
*/
void ldapsvr_free( LdapServer *server ) {
g_return_if_fail( server != NULL );
/* Stop and cancel any queries that may be active */
ldapsvr_stop_all_query( server );
ldapsvr_cancel_all_query( server );
/* Clear cache */
addrcache_clear( server->addressCache );
addrcache_free( server->addressCache );
/* Free LDAP control block */
ldapctl_free( server->control );
server->control = NULL;
/* Free all queries */
ldapsvr_free_all_query( server );
/* Clear pointers */
server->type = ADBOOKTYPE_NONE;
server->addressCache = NULL;
server->retVal = MGU_SUCCESS;
server->listQuery = NULL;
server->searchFlag = FALSE;
/* Now release LDAP object */
g_free( server );
}
/**
* Display object to specified stream.
* \param server Server object.
* \param stream Output stream.
*/
void ldapsvr_print_data( LdapServer *server, FILE *stream ) {
GList *node;
gint i;
g_return_if_fail( server != NULL );
fprintf( stream, "LdapServer:\n" );
fprintf( stream, " ret val: %d\n", server->retVal );
fprintf( stream, "srch flag: %s\n",
server->searchFlag ? "yes" : "no" );
if( server->control ) {
ldapctl_print( server->control, stream );
}
else {
fprintf( stream, " control: NULL\n" );
}
addrcache_print( server->addressCache, stream );
addritem_print_item_folder( server->addressCache->rootFolder, stream );
/* Dump queries */
i = 1;
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
fprintf( stream, " query: %2d : %s\n", i, ADDRQUERY_NAME(qry) );
i++;
node = g_list_next( node );
}
}
/**
* Return link list of persons.
* \param server Server object.
* \return List of persons.
*/
GList *ldapsvr_get_list_person( LdapServer *server ) {
g_return_val_if_fail( server != NULL, NULL );
return addrcache_get_list_person( server->addressCache );
}
/**
* Return link list of folders. There are no "real" folders that are returned
* from the server.
* \param server Server object.
* \return List of folders.
*/
GList *ldapsvr_get_list_folder( LdapServer *server ) {
g_return_val_if_fail( server != NULL, NULL );
/* return addrcache_get_list_folder( server->addressCache ); */
return NULL;
}
/**
* Execute specified query.
* \param server LDAP server.
* \param qry LDAP query.
*/
void ldapsvr_execute_query( LdapServer *server, LdapQuery *qry ) {
LdapControl *ctlCopy;
g_return_if_fail( server != NULL );
g_return_if_fail( qry != NULL );
/* Copy server's control data to the query */
ctlCopy = ldapctl_create();
ldapctl_copy( server->control, ctlCopy );
ldapqry_set_control( qry, ctlCopy );
ldapqry_initialize();
/* Perform query */
/* printf( "ldapsvr_execute_query::checking query...\n" ); */
if( ldapqry_check_search( qry ) ) {
/* printf( "ldapsvr_execute_query::reading with thread...\n" ); */
ldapqry_read_data_th( qry );
/*
if( qry->retVal == LDAPRC_SUCCESS ) {
printf( "ldapsvr_execute_query::SUCCESS with thread...\n" );
}
*/
}
/* printf( "ldapsvr_execute_query... terminated\n" ); */
}
/**
* Stop all queries for specified ID.
* \param server Server object.
* \param queryID Query ID to stop.
*/
void ldapsvr_stop_query_id( LdapServer *server, const gint queryID ) {
GList *node;
g_return_if_fail( server != NULL );
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
if( ADDRQUERY_ID(qry) == queryID ) {
/* Notify thread to stop */
ldapqry_set_stop_flag( qry, TRUE );
}
node = g_list_next( node );
}
}
/**
* Stop all queries by notifying each thread to stop.
* \param server Server object.
*/
void ldapsvr_stop_all_query( LdapServer *server ) {
GList *node;
g_return_if_fail( server != NULL );
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
ldapqry_set_stop_flag( qry, TRUE );
node = g_list_next( node );
}
}
/**
* Cancel all query threads for server.
* \param server Server object.
*/
void ldapsvr_cancel_all_query( LdapServer *server ) {
GList *node;
g_return_if_fail( server != NULL );
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
/* Notify thread to stop */
ldapqry_set_stop_flag( qry, TRUE );
/* Now cancel thread */
ldapqry_cancel( qry );
node = g_list_next( node );
}
}
/**
* Search most recent query for specified search term. The most recent
* completed query is returned. If no completed query is found, the most recent
* incomplete is returned.
* \param server LdapServer.
* \param searchTerm Search term to locate.
* \return Query object, or <i>NULL</i> if none found.
*/
static LdapQuery *ldapsvr_locate_query(
const LdapServer *server, const gchar *searchTerm )
{
LdapQuery *incomplete = NULL;
GList *node;
g_return_val_if_fail( server != NULL, NULL );
node = server->listQuery;
node = g_list_last( node );
/* Search backwards for query */
while( node ) {
LdapQuery *qry = node->data;
if( g_utf8_collate( ADDRQUERY_SEARCHVALUE(qry), searchTerm ) == 0 ) {
if( qry->agedFlag ) continue;
if( qry->completed ) {
/* Found */
return qry;
}
if( ! incomplete ) {
incomplete = qry;
}
}
node = g_list_previous( node );
}
return incomplete;
}
/**
* Retire aged queries. Only the following queries are retired:
*
* a) Dynamic queries.
* b) Explicit searches that have a hidden folders.
* c) Locate searches that have a hidden folder.
*
* \param server LdapServer.
*/
void ldapsvr_retire_query( LdapServer *server ) {
GList *node;
GList *listDelete;
GList *listQuery;
gint maxAge;
LdapControl *ctl;
ItemFolder *folder;
/* printf( "ldapsvr_retire_query\n" ); */
g_return_if_fail( server != NULL );
ctl = server->control;
maxAge = ctl->maxQueryAge;
/* Identify queries to age and move to deletion list */
listDelete = NULL;
node = server->listQuery;
while( node ) {
LdapQuery *qry = node->data;
node = g_list_next( node );
folder = ADDRQUERY_FOLDER(qry);
if( folder == NULL ) continue;
if( ! folder->isHidden ) {
if( ADDRQUERY_SEARCHTYPE(qry) == ADDRSEARCH_EXPLICIT ) continue;
if( ADDRQUERY_SEARCHTYPE(qry) == ADDRSEARCH_LOCATE ) continue;
}
ldapqry_age( qry, maxAge );
if( qry->agedFlag ) {
/* Delete folder associated with query */
/*
printf( "deleting folder... ::%s::\n", ADDRQUERY_NAME(qry) );
*/
ldapqry_delete_folder( qry );
listDelete = g_list_append( listDelete, qry );
}
}
/* Delete queries */
listQuery = server->listQuery;
node = listDelete;
while( node ) {
LdapQuery *qry = node->data;
listQuery = g_list_remove( listQuery, qry );
ldapqry_free( qry );
node->data = NULL;
node = g_list_next( node );
}
server->listQuery = listQuery;
/* Free up deletion list */
g_list_free( listDelete );
}
/**
* Return results of a previous query by executing callback for each address
* contained in specified folder.
*
* \param folder Address book folder to process.
* \param req Address query request object.
*/
static void ldapsvr_previous_query(
const ItemFolder *folder, const QueryRequest *req, AddrQueryObject *aqo )
{
AddrSearchCallbackEntry *callBack;
GList *listEMail;
GList *node;
GList *nodeEM;
gpointer sender;
sender = aqo;
callBack = ( AddrSearchCallbackEntry * ) req->callBackEntry;
if( callBack ) {
listEMail = NULL;
node = folder->listPerson;
while( node ) {
AddrItemObject *aio = node->data;
if( aio && aio->type == ITEMTYPE_PERSON ) {
ItemPerson *person = node->data;
nodeEM = person->listEMail;
while( nodeEM ) {
ItemEMail *email = nodeEM->data;
nodeEM = g_list_next( nodeEM );
listEMail = g_list_append( listEMail, email );
}
}
node = g_list_next( node );
}
( callBack ) ( sender, req->queryID, listEMail, NULL );
/* // g_list_free( listEMail ); */
}
}
/**
* Reuse search results from a previous LDAP query. If there is a query that
* has the same search term as specified in the query request, then the query
* will be reused.
*
* \param server LDAP server object.
* \param req Address query object.
* \return <i>TRUE</i> if previous query was used.
*/
gboolean ldapsvr_reuse_previous( const LdapServer *server, const QueryRequest *req ) {
LdapQuery *qry;
gchar *searchTerm;
ItemFolder *folder;
g_return_val_if_fail( server != NULL, FALSE );
g_return_val_if_fail( req != NULL, FALSE );
searchTerm = req->searchTerm;
/* Test whether any queries for the same term exist */
qry = ldapsvr_locate_query( server, searchTerm );
if( qry ) {
/* Touch query to ensure it hangs around for a bit longer */
ldapqry_touch( qry );
folder = ADDRQUERY_FOLDER(qry);
if( folder ) {
ldapsvr_previous_query( folder, req, ADDRQUERY_OBJECT(qry) );
return TRUE;
}
}
return FALSE;
}
/**
* Construct a new LdapQuery object that will be used to perform an dynamic
* search request.
*
* \param server LdapServer.
* \param req Query request.
* \return LdapQuery object, or <i>NULL</i> if none created.
*/
LdapQuery *ldapsvr_new_dynamic_search( LdapServer *server, QueryRequest *req )
{
LdapQuery *qry;
gchar *name;
gchar *searchTerm;
ItemFolder *folder;
g_return_val_if_fail( server != NULL, NULL );
g_return_val_if_fail( req != NULL, NULL );
/* Retire any aged queries */
/* // ldapsvr_retire_query( server ); */
/* Name of folder and query */
searchTerm = req->searchTerm;
name = g_strdup_printf( "Search '%s'", searchTerm );
/* Create a folder for the search results */
folder = addrcache_add_new_folder( server->addressCache, NULL );
addritem_folder_set_name( folder, name );
addritem_folder_set_remarks( folder, "" );
/* Construct a query */
qry = ldapqry_create();
ldapqry_set_query_id( qry, req->queryID );
ldapqry_set_search_value( qry, searchTerm );
ldapqry_set_search_type( qry, ADDRSEARCH_DYNAMIC );
ldapqry_set_callback_entry( qry, req->callBackEntry );
ldapqry_set_callback_end( qry, req->callBackEnd );
/* Specify folder type and back reference */
ADDRQUERY_FOLDER(qry) = folder;
folder->folderType = ADDRFOLDER_QUERY_RESULTS;
folder->folderData = ( gpointer ) qry;
folder->isHidden = TRUE;
/* Name the query */
ldapqry_set_name( qry, name );
g_free( name );
/* Add query to request */
qryreq_add_query( req, ADDRQUERY_OBJECT(qry) );
/* Now start the search */
ldapsvr_add_query( server, qry );
return qry;
}
/**
* Construct a new LdapQuery object that will be used to perform an explicit
* search request.
*
* \param server LdapServer.
* \param req Query request.
* \param folder Folder that will be used to contain search results.
* \return LdapQuery object, or <i>NULL</i> if none created.
*/
LdapQuery *ldapsvr_new_explicit_search(
LdapServer *server, QueryRequest *req, ItemFolder *folder )
{
LdapQuery *qry;
gchar *searchTerm;
gchar *name;
g_return_val_if_fail( server != NULL, NULL );
g_return_val_if_fail( req != NULL, NULL );
g_return_val_if_fail( folder != NULL, NULL );
/* Retire any aged queries */
/* // ldapsvr_retire_query( server ); */
/* Name the query */
searchTerm = req->searchTerm;
name = g_strdup_printf( "Explicit search for '%s'", searchTerm );
/* Construct a query */
qry = ldapqry_create();
ldapqry_set_query_id( qry, req->queryID );
ldapqry_set_name( qry, name );
ldapqry_set_search_value( qry, searchTerm );
ldapqry_set_search_type( qry, ADDRSEARCH_EXPLICIT );
ldapqry_set_callback_end( qry, req->callBackEnd );
ldapqry_set_callback_entry( qry, req->callBackEntry );
/* Specify folder type and back reference */
ADDRQUERY_FOLDER(qry) = folder;
folder->folderType = ADDRFOLDER_QUERY_RESULTS;
folder->folderData = ( gpointer ) qry;
/* Setup server */
ldapsvr_add_query( server, qry );
/* Set up query request */
qryreq_add_query( req, ADDRQUERY_OBJECT(qry) );
g_free( name );
return qry;
}
#endif /* USE_LDAP */
/*
* End of Source.
*/