Add browse LDAP entry.
authorMatch Grun <match@dimensional.com>
Sun, 2 Nov 2003 03:51:26 +0000 (03:51 +0000)
committerMatch Grun <match@dimensional.com>
Sun, 2 Nov 2003 03:51:26 +0000 (03:51 +0000)
src/addrdefs.h [new file with mode: 0644]
src/browseldap.c [new file with mode: 0644]
src/browseldap.h [new file with mode: 0644]
src/ldaplocate.c [new file with mode: 0644]
src/ldaplocate.h [new file with mode: 0644]

diff --git a/src/addrdefs.h b/src/addrdefs.h
new file mode 100644 (file)
index 0000000..5a09948
--- /dev/null
@@ -0,0 +1,44 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 2003 Match Grun
+ *
+ * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * General address definitions.
+ */
+
+#ifndef __ADDRDEFS_H__
+#define __ADDRDEFS_H__
+
+/* Query types */
+typedef enum {
+       ADDRQUERY_NONE,
+       ADDRQUERY_LDAP
+} AddrQueryType;
+
+/* Search type */
+typedef enum {
+       ADDRSEARCH_NONE,
+       ADDRSEARCH_SEARCH,
+       ADDRSEARCH_LOCATE
+} AddrSearchType;
+
+#endif /* __ADDRDEFS_H__ */
+
+/*
+* End of Source.
+*/
diff --git a/src/browseldap.c b/src/browseldap.c
new file mode 100644 (file)
index 0000000..d0d72f5
--- /dev/null
@@ -0,0 +1,439 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 2003 Match Grun
+ *
+ * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Browse LDAP entry.
+ */
+
+#ifdef HAVE_CONFIG_H
+#  include "config.h"
+#endif
+
+#include "defs.h"
+
+#include <glib.h>
+#include <gdk/gdkkeysyms.h>
+#include <gtk/gtkwindow.h>
+#include <gtk/gtksignal.h>
+#include <gtk/gtkhbox.h>
+#include <gtk/gtklabel.h>
+#include <gtk/gtkentry.h>
+#include <gtk/gtkhbbox.h>
+#include <gtk/gtkbutton.h>
+
+#include <pthread.h>
+#include "intl.h"
+#include "gtkutils.h"
+#include "stock_pixmap.h"
+#include "prefs_common.h"
+#include "browseldap.h"
+#include "addritem.h"
+#include "addrindex.h"
+#include "manage_window.h"
+
+#include "ldapquery.h"
+#include "ldapserver.h"
+#include "ldaplocate.h"
+
+typedef enum {
+       COL_NAME  = 0,
+       COL_VALUE = 1
+} LDAPEntryColumnPos;
+
+#define BROWSELDAP_WIDTH    450
+#define BROWSELDAP_HEIGHT   420
+
+#define N_COLS              2
+#define COL_WIDTH_NAME      140
+#define COL_WIDTH_VALUE     140
+
+static struct _LDAPEntry_dlg {
+       GtkWidget *window;
+       GtkWidget *label_server;
+       GtkWidget *label_address;
+       GtkWidget *list_entry;
+       GtkWidget *close_btn;
+       GtkWidget *statusbar;
+       gint status_cid;
+} browseldap_dlg;
+
+/**
+ * Message queue.
+ */
+static GList *_displayQueue_ = NULL;
+
+/**
+ * Mutex to protect callback from multiple threads.
+ */
+static pthread_mutex_t _browseMutex_ = PTHREAD_MUTEX_INITIALIZER;
+
+/**
+ * Current query ID.
+ */
+static gint _queryID_ = 0;
+
+/**
+ * Completion idle ID.
+ */
+static guint _browseIdleID_ = 0;
+
+/**
+ * Search complete indicator.
+ */
+static gboolean _searchComplete_ = FALSE;
+
+/**
+ * Callback entry point for each LDAP entry processed. The background thread
+ * (if any) appends the address list to the display queue.
+ * 
+ * \param qry        LDAP query object.
+ * \param queryID    Query ID of search request.
+ * \param listEMail  List of zero of more email objects that met search
+ *                   criteria.
+ * \param data       User data.
+ */
+static gint browse_callback_entry(
+               LdapQuery *qry, gint queryID, GList *listValues, gpointer data )
+{
+       GList *node;
+       NameValuePair *nvp;
+
+       /* printf( "browse_callback_entry...\n" ); */
+       pthread_mutex_lock( & _browseMutex_ );
+       /* Append contents to end of display queue */
+       node = listValues;
+       while( node ) {
+               nvp = ( NameValuePair * ) node->data;
+               /* ldapqry_print_name_value( nvp, stdout ); */
+               _displayQueue_ = g_list_append( _displayQueue_, nvp );
+               node->data = NULL;
+               node = g_list_next( node );
+       }
+       pthread_mutex_unlock( & _browseMutex_ );
+       /* printf( "browse_callback_entry...done\n" ); */
+
+       return 0;
+}
+
+/**
+ * Callback entry point for end of LDAP locate search.
+ * 
+ * \param qry     LDAP query object.
+ * \param queryID Query ID of search request.
+ * \param status  Status/error code.
+ * \param data    User data.
+ */
+static gint browse_callback_end(
+               LdapQuery *qry, gint queryID, gint status, gpointer data )
+{
+       _searchComplete_ = TRUE;
+}
+
+/**
+ * Clear the display queue.
+ */
+static void browse_clear_queue( void ) {
+       /* Clear out display queue */
+       pthread_mutex_lock( & _browseMutex_ );
+
+       ldapqry_free_list_name_value( _displayQueue_ );
+       g_list_free( _displayQueue_ );
+       _displayQueue_ = NULL;
+
+       pthread_mutex_unlock( & _browseMutex_ );
+}
+
+/**
+ * Clear message in status bar.
+ * \param msg Message.
+ */
+static void browse_status_show( gchar *msg ) {
+       if( browseldap_dlg.statusbar != NULL ) {
+               gtk_statusbar_pop( GTK_STATUSBAR(browseldap_dlg.statusbar),
+                       browseldap_dlg.status_cid );
+               if( msg ) {
+                       gtk_statusbar_push(
+                               GTK_STATUSBAR(browseldap_dlg.statusbar),
+                               browseldap_dlg.status_cid, msg );
+               }
+       }
+}
+
+/**
+ * Close window callback.
+ * \param widget    Widget.
+ * \param event     Event.
+ * \param cancelled Cancelled flag.
+ */
+static gint browse_delete_event(
+               GtkWidget *widget, GdkEventAny *event, gboolean *cancelled )
+{
+       gtk_main_quit();
+       return TRUE;
+}
+
+/**
+ * Respond to key press in window.
+ * \param widget    Widget.
+ * \param event     Event.
+ * \param cancelled Cancelled flag.
+ */
+static void browse_key_pressed(
+               GtkWidget *widget, GdkEventKey *event, gboolean *cancelled )
+{
+       if (event && event->keyval == GDK_Escape) {
+               gtk_main_quit();
+       }
+}
+
+/**
+ * Callback to close window.
+ * \param widget    Widget.
+ * \param cancelled Cancelled flag.
+ */
+static void browse_close( GtkWidget *widget, gboolean *cancelled ) {
+       gtk_main_quit();
+}
+
+/**
+ * Create the window to display data.
+ */
+static void browse_create( void ) {
+       GtkWidget *window;
+       GtkWidget *vbox;
+       GtkWidget *table;
+       GtkWidget *label;
+       GtkWidget *label_server;
+       GtkWidget *label_addr;
+       GtkWidget *list_entry;
+       GtkWidget *vlbox;
+       GtkWidget *tree_win;
+       GtkWidget *hbbox;
+       GtkWidget *close_btn;
+       GtkWidget *hsbox;
+       GtkWidget *statusbar;
+       gint top;
+
+       window = gtk_window_new(GTK_WINDOW_DIALOG);
+       gtk_widget_set_usize( window, BROWSELDAP_WIDTH, BROWSELDAP_HEIGHT );
+       gtk_container_set_border_width( GTK_CONTAINER(window), 0 );
+       gtk_window_set_title( GTK_WINDOW(window), _("Browse Directory Entry") );
+       gtk_window_set_position( GTK_WINDOW(window), GTK_WIN_POS_MOUSE );
+       gtk_window_set_modal( GTK_WINDOW(window), TRUE );
+       gtk_signal_connect( GTK_OBJECT(window), "delete_event",
+                           GTK_SIGNAL_FUNC(browse_delete_event), NULL );
+       gtk_signal_connect( GTK_OBJECT(window), "key_press_event",
+                           GTK_SIGNAL_FUNC(browse_key_pressed), NULL );
+
+       vbox = gtk_vbox_new(FALSE, 8);
+       gtk_container_add(GTK_CONTAINER(window), vbox);
+       gtk_container_set_border_width( GTK_CONTAINER(vbox), 8 );
+
+       table = gtk_table_new(2, 2, FALSE);
+       gtk_box_pack_start(GTK_BOX(vbox), table, FALSE, FALSE, 0);
+       gtk_container_set_border_width( GTK_CONTAINER(table), 8 );
+       gtk_table_set_row_spacings(GTK_TABLE(table), 8);
+       gtk_table_set_col_spacings(GTK_TABLE(table), 8);
+
+       /* First row */
+       top = 0;
+       label = gtk_label_new(_("Server Name :"));
+       gtk_table_attach(GTK_TABLE(table), label, 0, 1, top, (top + 1), GTK_FILL, 0, 0, 0);
+       gtk_misc_set_alignment(GTK_MISC(label), 1, 0.5);
+
+       label_server = gtk_label_new("");
+       gtk_table_attach(GTK_TABLE(table), label_server, 1, 2, top, (top + 1), GTK_FILL, 0, 0, 0);
+       gtk_misc_set_alignment(GTK_MISC(label_server), 0, 0.5);
+
+       /* Second row */
+       top++;
+       label = gtk_label_new(_("Distinguished Name (dn) :"));
+       gtk_table_attach(GTK_TABLE(table), label, 0, 1, top, (top + 1), GTK_FILL, 0, 0, 0);
+       gtk_misc_set_alignment(GTK_MISC(label), 1, 0.5);
+
+       label_addr = gtk_label_new("");
+       gtk_table_attach(GTK_TABLE(table), label_addr, 1, 2, top, (top + 1), GTK_FILL, 0, 0, 0);
+       gtk_misc_set_alignment(GTK_MISC(label_addr), 0, 0.5);
+
+       /* Address book/folder tree */
+       vlbox = gtk_vbox_new(FALSE, 8);
+       gtk_box_pack_start(GTK_BOX(vbox), vlbox, TRUE, TRUE, 0);
+       gtk_container_set_border_width( GTK_CONTAINER(vlbox), 8 );
+
+       tree_win = gtk_scrolled_window_new( NULL, NULL );
+       gtk_scrolled_window_set_policy( GTK_SCROLLED_WINDOW(tree_win),
+                                       GTK_POLICY_AUTOMATIC,
+                                       GTK_POLICY_ALWAYS );
+       gtk_box_pack_start( GTK_BOX(vlbox), tree_win, TRUE, TRUE, 0 );
+
+       list_entry = gtk_clist_new( N_COLS );
+       gtk_container_add( GTK_CONTAINER(tree_win), list_entry );
+       gtk_clist_column_titles_show( GTK_CLIST(list_entry) );
+       gtk_clist_set_column_title(
+               GTK_CLIST(list_entry), COL_NAME, _( "LDAP Name" ) );
+       gtk_clist_set_column_title(
+               GTK_CLIST(list_entry), COL_VALUE, _( "Attribute Value" ) );
+       gtk_clist_set_selection_mode(
+               GTK_CLIST(list_entry), GTK_SELECTION_BROWSE );
+       gtk_clist_set_column_width( GTK_CLIST(list_entry),
+               COL_NAME, COL_WIDTH_NAME );
+       gtk_clist_set_auto_sort( GTK_CLIST(list_entry), TRUE );
+
+       /* Status line */
+       hsbox = gtk_hbox_new(FALSE, 0);
+       gtk_box_pack_end(GTK_BOX(vbox), hsbox, FALSE, FALSE, BORDER_WIDTH);
+       statusbar = gtk_statusbar_new();
+       gtk_box_pack_start(GTK_BOX(hsbox), statusbar, TRUE, TRUE, BORDER_WIDTH);
+
+       /* Button panel */
+       gtkut_button_set_create(&hbbox, &close_btn, _( "Close" ),
+                               NULL, NULL, NULL, NULL);
+       gtk_box_pack_end(GTK_BOX(vbox), hbbox, FALSE, FALSE, 0);
+       gtk_container_set_border_width( GTK_CONTAINER(hbbox), 0 );
+
+       gtk_signal_connect(GTK_OBJECT(close_btn), "clicked",
+                          GTK_SIGNAL_FUNC(browse_close), NULL);
+       gtk_widget_grab_default(close_btn);
+
+       gtk_widget_show_all(vbox);
+
+       browseldap_dlg.window        = window;
+       browseldap_dlg.label_server  = label_server;
+       browseldap_dlg.label_address = label_addr;
+       browseldap_dlg.list_entry    = list_entry;
+       browseldap_dlg.close_btn     = close_btn;
+       browseldap_dlg.statusbar     = statusbar;
+       browseldap_dlg.status_cid    =
+               gtk_statusbar_get_context_id(
+                       GTK_STATUSBAR(statusbar), "Browse LDAP" );
+
+       gtk_widget_show_all( window );
+
+}
+
+/**
+ * Idler function. This function is called by the main (UI) thread during UI
+ * idle time while an address search is in progress. Items from the display
+ * queue are processed and appended to the address list.
+ *
+ * \param data Target data object.
+ * \return <i>TRUE</i> to ensure that idle event do not get ignored.
+ */
+static gboolean browse_idle( gpointer data ) {
+       GList *node;
+       NameValuePair *nvp;
+       gchar *text[N_COLS];
+
+       /* Process all entries in display queue */
+       pthread_mutex_lock( & _browseMutex_ );
+       if( _displayQueue_ ) {
+               node = _displayQueue_;
+               while( node ) {
+                       /* Add entry into list */
+                       nvp = ( NameValuePair * ) node->data;
+                       text[COL_NAME]  = nvp->name;
+                       text[COL_VALUE] = nvp->value;
+                       gtk_clist_append(
+                               GTK_CLIST(browseldap_dlg.list_entry), text );
+
+                       /* Free up entry */
+                       ldapqry_free_name_value( nvp );
+                       node->data = NULL;
+                       node = g_list_next( node );
+               }
+               g_list_free( _displayQueue_ );
+               _displayQueue_ = NULL;
+       }
+       pthread_mutex_unlock( & _browseMutex_ );
+
+       if( _searchComplete_ ) {
+               /* Remove idler */
+               if( _browseIdleID_ != 0 ) {
+                       gtk_idle_remove( _browseIdleID_ );
+                       _browseIdleID_ = 0;
+                       gtk_clist_select_row(
+                               GTK_CLIST( browseldap_dlg.list_entry ), 0, 0 );
+               }
+       }
+
+       return TRUE;
+}
+
+/**
+ * Main entry point to browse LDAP entries.
+ * \param  ds Data source to process.
+ * \param  dn Distinguished name to retrieve.
+ * \return <code>TRUE</code>
+ */
+gboolean browseldap_entry( AddressDataSource *ds, const gchar *dn ) {
+       LdapServer *server;
+
+       _queryID_ = 0;
+       _browseIdleID_ = 0;
+
+       server = ds->rawDataSource;
+
+       if( ! browseldap_dlg.window ) browse_create();
+       gtk_widget_grab_focus(browseldap_dlg.close_btn);
+       gtk_widget_show(browseldap_dlg.window);
+       manage_window_set_transient(GTK_WINDOW(browseldap_dlg.window));
+
+       browse_status_show( "" );
+       gtk_clist_select_row( GTK_CLIST( browseldap_dlg.list_entry ), 0, 0 );
+       gtk_widget_show(browseldap_dlg.window);
+
+       gtk_label_set_text( GTK_LABEL(browseldap_dlg.label_address ), "" );
+       if( dn ) {
+               gtk_label_set_text(
+                       GTK_LABEL(browseldap_dlg.label_address ), dn );
+       }
+       gtk_label_set_text(
+               GTK_LABEL(browseldap_dlg.label_server ),
+               ldapsvr_get_name( server ) );
+
+       /* Setup search */
+       _searchComplete_ = FALSE;
+       _queryID_ = ldaplocate_search_setup(
+                       server, dn, browse_callback_entry, browse_callback_end );
+       _browseIdleID_ = gtk_idle_add( ( GtkFunction ) browse_idle, NULL );
+
+       /* Start search */
+       ldaplocate_search_start( _queryID_ );
+
+       /* Display dialog */
+       gtk_main();
+       gtk_widget_hide( browseldap_dlg.window );
+
+       /* Stop query */
+       ldaplocate_search_stop( _queryID_ );
+
+       if( _browseIdleID_ != 0 ) {
+               gtk_idle_remove( _browseIdleID_ );
+               _browseIdleID_ = 0;
+       }
+       browse_clear_queue();
+       gtk_clist_clear( GTK_CLIST( browseldap_dlg.list_entry ) );
+
+       return TRUE;
+}
+
+/*
+* End of Source.
+*/
+
diff --git a/src/browseldap.h b/src/browseldap.h
new file mode 100644 (file)
index 0000000..d3121d7
--- /dev/null
@@ -0,0 +1,31 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 2003 Match Grun
+ *
+ * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Browse LDAP entry.
+ */
+
+#ifndef __BROWSE_LDAP_H__
+#define __BROWSE_LDAP_H__
+
+#include "addrindex.h"
+
+gboolean browseldap_entry( AddressDataSource *ds, const gchar *dn );
+
+#endif /* __BROWSE_LDAP_H__ */
diff --git a/src/ldaplocate.c b/src/ldaplocate.c
new file mode 100644 (file)
index 0000000..dc57c6c
--- /dev/null
@@ -0,0 +1,150 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 2003 Match Grun
+ *
+ * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Functions to perform searches for LDAP entries.
+ */
+
+#ifdef HAVE_CONFIG_H
+#  include "config.h"
+#endif
+
+#ifdef USE_LDAP
+
+#include <glib.h>
+#include "addrquery.h"
+#include "ldapserver.h"
+#include "ldapquery.h"
+
+/**
+ * Setup the search that will be performed and registered with the query
+ * manager.
+ *
+ * \param  server        LDAP server object.
+ * \param  searchTerm    Search term to locate.
+ * \param  callBackEntry Function to call when each attribute is returned.
+ * \param  callBackEnd   Function to call when search is complete.
+ * \return Query ID allocated to query that will be executed.
+ */
+gint ldaplocate_search_setup(
+       LdapServer *server, const gchar *searchTerm, void *callBackEntry,
+       void *callBackEnd )
+{
+       QueryRequest *req;
+       LdapQuery *qry;
+       gint queryID;
+       gchar *name;
+
+       /* Name the query */
+       name = g_strdup_printf( "Locate '%s'", searchTerm );
+
+       /* Set up a generic address query */
+       req = qrymgr_add_request( searchTerm, callBackEnd, callBackEntry );
+       qryreq_set_search_type( req, ADDRSEARCH_LOCATE );
+       queryID = req->queryID;
+
+       /* Construct a query */
+       qry = ldapqry_create();
+       ldapqry_set_query_id( qry, queryID );
+       ldapqry_set_name( qry, name );
+       ldapqry_set_search_value( qry, searchTerm );
+       ldapqry_set_search_type( qry, ADDRSEARCH_LOCATE );
+       ldapqry_set_callback_end( qry, callBackEnd );
+       ldapqry_set_callback_entry( qry, callBackEntry );
+
+       /* Setup server */
+       ldapsvr_add_query( server, qry );
+
+       /* Set up query request */
+       qryreq_add_query( req, ADDRQUERY_OBJECT(qry) );
+
+       g_free( name );
+
+       return queryID;
+}
+
+/**
+ * Perform the previously registered search.
+ * \param  queryID    ID of search query to be executed.
+ * \return <i>TRUE</i> if search started successfully, or <i>FALSE</i> if
+ *         failed.
+ */
+gboolean ldaplocate_search_start( const gint queryID ) {
+       gboolean retVal;
+       LdapServer *server;
+       LdapQuery *qry;
+       QueryRequest *req;
+       AddrQueryObject *aqo;
+
+       retVal = FALSE;
+       req = qrymgr_find_request( queryID );
+       if( req == NULL ) {
+               return retVal;
+       }
+
+       /* Note: there should only be one query in the list */
+       aqo = req->queryList->data;
+       if( aqo->queryType == ADDRQUERY_LDAP ) {
+               qry = ( LdapQuery * ) aqo;
+               server = qry->server;
+
+               /* Retire any aged queries */
+               ldapsvr_retire_query( server );
+
+               /* Start the search */
+               retVal = TRUE;
+               ldapsvr_execute_query( server, qry );
+       }
+       return retVal;
+}
+
+/**
+ * Notify search to stop execution.
+ * \param queryID Query to terminate.
+ */
+void ldaplocate_search_stop( const gint queryID ) {
+       QueryRequest *req;
+       AddrQueryObject *aqo;
+       LdapQuery *qry;
+       gint queryType;
+
+       req = qrymgr_find_request( queryID );
+       if( req == NULL ) {
+               return;
+       }
+
+       aqo = req->queryList->data;
+       if( aqo->queryType == ADDRQUERY_LDAP ) {
+               /* Notify query to stop */
+               qry = ( LdapQuery * ) aqo;
+               ldapqry_set_stop_flag( qry, TRUE );
+       }
+       req->queryList->data = NULL;
+
+       /* Delete query */
+       qrymgr_delete_request( queryID );
+}
+
+#endif /* USE_LDAP */
+
+/*
+ * End of Source.
+ */
+
+
diff --git a/src/ldaplocate.h b/src/ldaplocate.h
new file mode 100644 (file)
index 0000000..363c29e
--- /dev/null
@@ -0,0 +1,44 @@
+/*
+ * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 2003 Match Grun
+ *
+ * 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+/*
+ * Functions to perform searches for LDAP entries.
+ */
+
+#ifndef __LDAPLOCATE_H__
+#define __LDAPLOCATE_H__
+
+#ifdef USE_LDAP
+
+#include <glib.h>
+#include "ldapserver.h"
+
+/* Function prototypes */
+gint ldaplocate_search_setup   ( LdapServer *server,
+                                 const gchar *searchTerm,
+                                 void *callBackEntry,
+                                 void *callBackEnd );
+gboolean ldaplocate_search_start( const gint queryID );
+void ldaplocate_search_stop    ( const gint queryID );
+
+#endif /* USE_LDAP */
+
+#endif /* __LDAPLOCATE_H__ */
+
+