Contents in 1999-06-04-13 of release-21-2.
[chise/xemacs-chise.git.1] / src / eldap.h
1 /* Definitions for the LDAP client interface for XEmacs.
2    Copyright (C) 1998 Free Software Foundation, Inc.
3
4 This file is part of XEmacs.
5
6 XEmacs is free software; you can redistribute it and/or modify it
7 under the terms of the GNU General Public License as published by the
8 Free Software Foundation; either version 2, or (at your option) any
9 later version.
10
11 XEmacs is distributed in the hope that it will be useful, but WITHOUT
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with XEmacs; see the file COPYING.  If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA.  */
20
21 #ifndef _XEMACS_ELDAP_H_
22 #define _XEMACS_ELDAP_H_
23
24 #include <lber.h>
25 #include <ldap.h>
26
27 /*
28  * The following structure records pertinent information about a
29  * LDAP connection.
30  */
31
32 struct Lisp_LDAP
33 {
34   /* lcrecord header */
35   struct lcrecord_header header;
36   /* The LDAP connection handle used by the LDAP API */
37   LDAP *ld;
38   /* Name of the host we connected to */
39   Lisp_Object host;
40   /* Status of the LDAP connection.  */
41   int livep;
42 };
43
44
45 DECLARE_LRECORD (ldap, struct Lisp_LDAP);
46 #define XLDAP(x) XRECORD (x, ldap, struct Lisp_LDAP)
47 #define XSETLDAP(x, p) XSETRECORD (x, p, ldap)
48 #define LDAPP(x) RECORDP (x, ldap)
49 #define GC_LDAPP(x) GC_RECORDP (x, ldap)
50 #define CHECK_LDAP(x) CHECK_RECORD (x, ldap)
51 #define CONCHECK_LDAP(x) CONCHECK_RECORD (x, ldap)
52
53 #define CHECK_LIVE_LDAP(ldap) do {                                      \
54   CHECK_LDAP (ldap);                                                    \
55   if (!XLDAP (ldap)->livep)                                             \
56     signal_simple_error ("Attempting to access closed LDAP connection", \
57                          ldap);                                         \
58 } while (0)
59
60
61 Lisp_Object Fldapp (Lisp_Object object);
62 Lisp_Object Fldap_host (Lisp_Object ldap);
63 Lisp_Object Fldap_status (Lisp_Object ldap);
64 Lisp_Object Fldap_open (Lisp_Object host,
65                         Lisp_Object ldap_plist);
66 Lisp_Object Fldap_close (Lisp_Object ldap);
67 Lisp_Object Fldap_search_internal (Lisp_Object ldap,
68                                    Lisp_Object filter,
69                                    Lisp_Object base,
70                                    Lisp_Object scope,
71                                    Lisp_Object attrs,
72                                    Lisp_Object attrsonly,
73                                    Lisp_Object withdn);
74
75 #endif /* _XEMACS_ELDAP_H_ */