]> git.sur5r.net Git - openldap/blobdiff - servers/slapd/slapi/slapi.h
Use bi_db_{open,close} to run SLAPI start/close plugins
[openldap] / servers / slapd / slapi / slapi.h
index e219e87182e15356507c0ae5a3a8af81a08bc9ea..4eae15ca42e7535d188242afee19ba13f6ed58f0 100644 (file)
-/*
- * Copyright 1998-2003 The OpenLDAP Foundation, All Rights Reserved.
- * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
+/* $OpenLDAP$ */
+/* This work is part of OpenLDAP Software <http://www.openldap.org/>.
+ *
+ * Copyright 2002-2006 The OpenLDAP Foundation.
+ * Portions Copyright 1997,2002-2003 IBM Corporation.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
  */
-/*
- * (C) Copyright IBM Corp. 1997,2002
- * Redistribution and use in source and binary forms are permitted
- * provided that this notice is preserved and that due credit is 
- * given to IBM Corporation. This software is provided ``as is'' 
- * without express or implied warranty.
+/* ACKNOWLEDGEMENTS:
+ * This work was initially developed by IBM Corporation for use in
+ * IBM products and subsequently ported to OpenLDAP Software by
+ * Steve Omrani.  Additional significant contributors include:
+ *   Luke Howard
  */
 
+#ifdef LDAP_SLAPI /* SLAPI is OPTIONAL */
+
 #ifndef _SLAPI_H
 #define _SLAPI_H
 
-#include <ibm_pblock_params.h> 
-
 LDAP_BEGIN_DECL
 
-typedef struct slapi_pblock    Slapi_PBlock;
-typedef struct slap_entry      Slapi_Entry;
-typedef struct slap_attr       Slapi_Attr;
-typedef Filter                 Slapi_Filter;
+/*
+ * Quick 'n' dirty to make struct slapi_* in slapi-plugin.h opaque
+ */
+#define slapi_entry    slap_entry
+#define slapi_attr     slap_attr
+#define slapi_value    berval
+#define slapi_valueset berval *
+#define slapi_filter   slap_filter
 
 LDAP_END_DECL
 
-#include <slapi_utils.h>
-#ifndef NO_PBLOCK_CLASS
-#include <slapi_pblock.h>
-#endif /* NO_PBLOCK_CLASS */
-#include <plugin.h>
-#include <slapi_ops.h>
-#if 0 /* unused (yet?) */
-#include <slapi_cl.h>
-#endif /* 0 */
+#include <slapi-plugin.h>
 
 LDAP_BEGIN_DECL
 
+#define SLAPI_OVERLAY_NAME                     "slapi"
+
+#define SLAPI_OPERATION_PBLOCK(_op)            ((_op)->o_callback->sc_private)
+#define SLAPI_CONNECTION_PBLOCK(_conn)         ((_conn)->c_pb);
+#define SLAPI_BACKEND_PBLOCK(_be)              ((_be)->be_pb)
+
+#define SLAPI_OPERATION_EXTENSIONS(_op)                ((_op)->o_hdr->oh_extensions)
+#define SLAPI_CONNECTION_EXTENSIONS(_conn)     ((_conn)->c_extensions)
+
+#define SLAPI_CONTROL_MANAGEDSAIT_OID          LDAP_CONTROL_MANAGEDSAIT
+#define SLAPI_CONTROL_SORTEDSEARCH_OID         LDAP_CONTROL_SORTREQUEST
+#define SLAPI_CONTROL_PAGED_RESULTS_OID                LDAP_CONTROL_PAGEDRESULTS
+
+typedef int (*SLAPI_FUNC)( Slapi_PBlock *pb );
+
+typedef struct _slapi_control {
+        int                    s_ctrl_num;
+        char                   **s_ctrl_oids;
+        unsigned long          *s_ctrl_ops;
+} Slapi_Control;
+
+typedef struct _ExtendedOp {
+       struct berval           ext_oid;
+        SLAPI_FUNC             ext_func;
+        Backend                        *ext_be;
+        struct _ExtendedOp     *ext_next;
+} ExtendedOp;
+
+/* Computed attribute support */
+struct _computed_attr_context {
+       Slapi_PBlock    *cac_pb;
+       Operation       *cac_op;
+       void            *cac_private;
+};
+
+/* for slapi_attr_type_cmp() */
+#define SLAPI_TYPE_CMP_EXACT   0
+#define SLAPI_TYPE_CMP_BASE    1
+#define SLAPI_TYPE_CMP_SUBTYPE 2
+
+typedef enum slapi_extension_e {
+       SLAPI_X_EXT_CONNECTION = 0,
+       SLAPI_X_EXT_OPERATION = 1,
+       SLAPI_X_EXT_MAX = 2
+} slapi_extension_t;
+
+struct slapi_dn {
+       unsigned char flag;
+       struct berval dn;
+       struct berval ndn;
+};
+
+struct slapi_rdn {
+       unsigned char flag;
+       struct berval bv;
+       LDAPRDN rdn;
+};
+
 /*
- * Plugin types universally supported by SLAPI
- * implementations
+ * Was: slapi_pblock.h
  */
-#define SLAPI_PLUGIN_DATABASE           1
-#define SLAPI_PLUGIN_EXTENDEDOP         2
-#define SLAPI_PLUGIN_PREOPERATION       3
-#define SLAPI_PLUGIN_POSTOPERATION      4
-#define SLAPI_PLUGIN_MATCHINGRULE       5
-#define SLAPI_PLUGIN_SYNTAX             6
-/* XXX this is SLAPI_PLUGIN_ACL in SunDS */
-#define SLAPI_PLUGIN_AUDIT              7
+
+#ifndef NO_PBLOCK_CLASS                /* where's this test from? */
+
+typedef enum slapi_pblock_class_e {
+       PBLOCK_CLASS_INVALID = 0,
+       PBLOCK_CLASS_INTEGER,
+       PBLOCK_CLASS_LONG_INTEGER,
+       PBLOCK_CLASS_POINTER,
+       PBLOCK_CLASS_FUNCTION_POINTER
+} slapi_pblock_class_t;
+
+#define PBLOCK_SUCCESS                 (0)
+#define PBLOCK_ERROR                   (-1)
+#define PBLOCK_MAX_PARAMS              100
+
+union slapi_pblock_value {
+       int pv_integer;
+       long pv_long_integer;
+       void *pv_pointer;
+       int (*pv_function_pointer)();
+};
+
+struct slapi_pblock {
+       ldap_pvt_thread_mutex_t pb_mutex;
+       int                     pb_nParams;
+       int                     pb_params[PBLOCK_MAX_PARAMS];
+       union slapi_pblock_value pb_values[PBLOCK_MAX_PARAMS];
+       /* native types */
+       Connection              *pb_conn;
+       Operation               *pb_op;
+       SlapReply               *pb_rs;
+       int                     pb_intop;
+       char                    pb_textbuf[ SLAP_TEXT_BUFLEN ];
+};
+
+#endif /* !NO_PBLOCK_CLASS */
+
 /*
- * The following plugin types are reserved for future
- * Sun ONE DS compatability.
+ * Was: plugin.h
  */
-#define SLAPI_PLUGIN_BEPREOPERATION             8       
-#define SLAPI_PLUGIN_BEPOSTOPERATION            9       
-#define SLAPI_PLUGIN_ENTRY                      10      
-#define SLAPI_PLUGIN_TYPE_OBJECT                11      
-#define SLAPI_PLUGIN_INTERNAL_PREOPERATION      12      
-#define SLAPI_PLUGIN_INTERNAL_POSTOPERATION     13
-#define SLAPI_PLUGIN_PWD_STORAGE_SCHEME         14
-#define SLAPI_PLUGIN_VATTR_SP                   15
-#define SLAPI_PLUGIN_REVER_PWD_STORAGE_SCHEME   16
-
-#define SLAPI_PLUGIN_EXTENDED_SENT_RESULT       -1
-#define SLAPI_PLUGIN_EXTENDED_NOT_HANDLED       -2
-
-#define SLAPI_BIND_SUCCESS             0
-#define SLAPI_BIND_FAIL                        2
-#define SLAPI_BIND_ANONYMOUS           3
-
-#define SLAPI_BACKEND                          130
-#define SLAPI_CONNECTION                       131
-#define SLAPI_OPERATION                                132
-#define SLAPI_REQUESTOR_ISROOT                 133
-#define SLAPI_BE_MONITORDN                     134
-#define SLAPI_BE_TYPE                          135
-#define SLAPI_BE_READONLY                      136
-#define SLAPI_BE_LASTMOD                               137
-#define SLAPI_CONN_ID                          139
-
-#define SLAPI_OPINITIATED_TIME                 140
-#define SLAPI_REQUESTOR_DN                     141
-#define SLAPI_REQUESTOR_ISUPDATEDN             142
-#define SLAPI_CONN_DN                          143
-#define SLAPI_CONN_AUTHTYPE                            144
-
-#define SLAPD_AUTH_NONE   "none"
-#define SLAPD_AUTH_SIMPLE "simple"
-#define SLAPD_AUTH_SSL    "SSL"
-#define SLAPD_AUTH_SASL   "SASL "
-
-#define SLAPI_PLUGIN                           3
-#define SLAPI_PLUGIN_PRIVATE                   4
-#define SLAPI_PLUGIN_TYPE                      5
-#define SLAPI_PLUGIN_ARGV                      6
-#define SLAPI_PLUGIN_ARGC                      7
-#define SLAPI_PLUGIN_VERSION                   8
-
-#define SLAPI_PLUGIN_OPRETURN                  9
-#define SLAPI_PLUGIN_OBJECT                    10
-#define SLAPI_PLUGIN_DESTROY_FN                        11
-
-#define SLAPI_PLUGIN_DESCRIPTION               12
-
-#define SLAPI_PLUGIN_INTOP_RESULT              15
-#define SLAPI_PLUGIN_INTOP_SEARCH_ENTRIES      16
-#define SLAPI_PLUGIN_INTOP_SEARCH_REFERRALS    17
-
-#define SLAPI_PLUGIN_DB_BIND_FN                        200
-#define SLAPI_PLUGIN_DB_UNBIND_FN              201
-#define SLAPI_PLUGIN_DB_SEARCH_FN              202
-#define SLAPI_PLUGIN_DB_COMPARE_FN             203
-#define SLAPI_PLUGIN_DB_MODIFY_FN              204
-#define SLAPI_PLUGIN_DB_MODRDN_FN              205
-#define SLAPI_PLUGIN_DB_ADD_FN                 206
-#define SLAPI_PLUGIN_DB_DELETE_FN              207
-#define SLAPI_PLUGIN_DB_ABANDON_FN             208
-#define SLAPI_PLUGIN_DB_CONFIG_FN              209
-#define SLAPI_PLUGIN_CLOSE_FN                  210
-#define SLAPI_PLUGIN_DB_FLUSH_FN               211
-#define SLAPI_PLUGIN_START_FN                  212
-#define SLAPI_PLUGIN_DB_SEQ_FN                 213
-#define SLAPI_PLUGIN_DB_ENTRY_FN               214
-#define SLAPI_PLUGIN_DB_REFERRAL_FN            215
-#define SLAPI_PLUGIN_DB_RESULT_FN              216
-#define SLAPI_PLUGIN_DB_LDIF2DB_FN             217
-#define SLAPI_PLUGIN_DB_DB2LDIF_FN             218
-#define SLAPI_PLUGIN_DB_BEGIN_FN               219
-#define SLAPI_PLUGIN_DB_COMMIT_FN              220
-#define SLAPI_PLUGIN_DB_ABORT_FN               221
-#define SLAPI_PLUGIN_DB_ARCHIVE2DB_FN          222
-#define SLAPI_PLUGIN_DB_DB2ARCHIVE_FN          223
-#define SLAPI_PLUGIN_DB_NEXT_SEARCH_ENTRY_FN   224
-#define SLAPI_PLUGIN_DB_FREE_RESULT_SET_FN     225
-#define        SLAPI_PLUGIN_DB_SIZE_FN                 226
-#define        SLAPI_PLUGIN_DB_TEST_FN                 227
-#define SLAPI_PLUGIN_DB_NO_ACL                 250
 
-#define SLAPI_PLUGIN_EXT_OP_FN                 300
-#define SLAPI_PLUGIN_EXT_OP_OIDLIST            301
-#define SLAPI_PLUGIN_PRE_BIND_FN               401
-#define SLAPI_PLUGIN_PRE_UNBIND_FN             402
-#define SLAPI_PLUGIN_PRE_SEARCH_FN             403
-#define SLAPI_PLUGIN_PRE_COMPARE_FN            404
-#define SLAPI_PLUGIN_PRE_MODIFY_FN             405
-#define SLAPI_PLUGIN_PRE_MODRDN_FN             406
-#define SLAPI_PLUGIN_PRE_ADD_FN                        407
-#define SLAPI_PLUGIN_PRE_DELETE_FN             408
-#define SLAPI_PLUGIN_PRE_ABANDON_FN            409
-#define SLAPI_PLUGIN_PRE_ENTRY_FN              410
-#define SLAPI_PLUGIN_PRE_REFERRAL_FN           411
-#define SLAPI_PLUGIN_PRE_RESULT_FN             412
-#define SLAPI_PLUGIN_POST_BIND_FN              501
-#define SLAPI_PLUGIN_POST_UNBIND_FN            502
-#define SLAPI_PLUGIN_POST_SEARCH_FN            503
-#define SLAPI_PLUGIN_POST_COMPARE_FN           504
-#define SLAPI_PLUGIN_POST_MODIFY_FN            505
-#define SLAPI_PLUGIN_POST_MODRDN_FN            506
-#define SLAPI_PLUGIN_POST_ADD_FN               507
-#define SLAPI_PLUGIN_POST_DELETE_FN            508
-#define SLAPI_PLUGIN_POST_ABANDON_FN           509
-#define SLAPI_PLUGIN_POST_ENTRY_FN             510
-#define SLAPI_PLUGIN_POST_REFERRAL_FN          511
-#define SLAPI_PLUGIN_POST_RESULT_FN            512
-
-#define SLAPI_PLUGIN_MR_FILTER_CREATE_FN       600
-#define SLAPI_PLUGIN_MR_INDEXER_CREATE_FN      601
-#define SLAPI_PLUGIN_MR_FILTER_MATCH_FN                602
-#define SLAPI_PLUGIN_MR_FILTER_INDEX_FN                603
-#define SLAPI_PLUGIN_MR_FILTER_RESET_FN                604
-#define SLAPI_PLUGIN_MR_INDEX_FN               605
-#define SLAPI_PLUGIN_MR_OID                    610
-#define SLAPI_PLUGIN_MR_TYPE                   611
-#define SLAPI_PLUGIN_MR_VALUE                  612
-#define SLAPI_PLUGIN_MR_VALUES                 613
-#define SLAPI_PLUGIN_MR_KEYS                   614
-#define SLAPI_PLUGIN_MR_FILTER_REUSABLE                615
-#define SLAPI_PLUGIN_MR_QUERY_OPERATOR         616
-#define SLAPI_PLUGIN_MR_USAGE                  617
-
-#define SLAPI_OP_LESS                                  1
-#define SLAPI_OP_LESS_OR_EQUAL                         2
-#define SLAPI_OP_EQUAL                                 3
-#define SLAPI_OP_GREATER_OR_EQUAL                      4
-#define SLAPI_OP_GREATER                               5
-#define SLAPI_OP_SUBSTRING                             6
-
-#define SLAPI_PLUGIN_MR_USAGE_INDEX            0
-#define SLAPI_PLUGIN_MR_USAGE_SORT             1
-
-#define SLAPI_PLUGIN_SYNTAX_FILTER_AVA         700
-#define SLAPI_PLUGIN_SYNTAX_FILTER_SUB         701
-#define SLAPI_PLUGIN_SYNTAX_VALUES2KEYS                702
-#define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_AVA 703
-#define SLAPI_PLUGIN_SYNTAX_ASSERTION2KEYS_SUB 704
-#define SLAPI_PLUGIN_SYNTAX_NAMES              705
-#define SLAPI_PLUGIN_SYNTAX_OID                        706
-#define SLAPI_PLUGIN_SYNTAX_FLAGS              707
-#define SLAPI_PLUGIN_SYNTAX_COMPARE            708
-
-#define SLAPI_RESULT_CODE                      881
-#define SLAPI_RESULT_TEXT                      882
-#define SLAPI_RESULT_MATCHED                   883
-
-#define SLAPI_PLUGIN_SYNTAX_FLAG_ORKEYS                        1
-#define SLAPI_PLUGIN_SYNTAX_FLAG_ORDERING              2
-
-#define SLAPI_PLUGIN_AUDIT_DATA                 1100
-#define SLAPI_PLUGIN_AUDIT_FN                   1101
-
-#define SLAPI_MANAGEDSAIT                      1000
-
-#define SLAPI_CONFIG_FILENAME                  40
-#define SLAPI_CONFIG_LINENO                    41
-#define SLAPI_CONFIG_ARGC                      42
-#define SLAPI_CONFIG_ARGV                      43
-
-#define SLAPI_TARGET_DN                                50
-#define SLAPI_REQCONTROLS                      51
+#define SLAPI_PLUGIN_IS_POST_FN(x) ((x) >= SLAPI_PLUGIN_POST_BIND_FN && (x) <= SLAPI_PLUGIN_BE_POST_DELETE_FN)
+
+#define SLAPI_IBM_PBLOCK                       -3
 
 #define        SLAPI_ENTRY_PRE_OP                      52
 #define        SLAPI_ENTRY_POST_OP                     53
 
-#define SLAPI_RESCONTROLS                      55
-#define SLAPI_ADD_RESCONTROL                   56
-
-#define SLAPI_ADD_TARGET                       SLAPI_TARGET_DN
-#define SLAPI_ADD_ENTRY                                60
-
-#define SLAPI_BIND_TARGET                      SLAPI_TARGET_DN
-#define SLAPI_BIND_METHOD                      70
-#define SLAPI_BIND_CREDENTIALS                 71
-#define SLAPI_BIND_SASLMECHANISM               72
-#define SLAPI_BIND_RET_SASLCREDS               73
-
-#define SLAPI_COMPARE_TARGET                   SLAPI_TARGET_DN
-#define SLAPI_COMPARE_TYPE                     80
-#define SLAPI_COMPARE_VALUE                    81
-
-#define SLAPI_DELETE_TARGET                    SLAPI_TARGET_DN
-
-#define SLAPI_MODIFY_TARGET                    SLAPI_TARGET_DN
-#define SLAPI_MODIFY_MODS                      90
-
-#define SLAPI_MODRDN_TARGET                    SLAPI_TARGET_DN
-#define SLAPI_MODRDN_NEWRDN                    100
-#define SLAPI_MODRDN_DELOLDRDN                 101
-#define SLAPI_MODRDN_NEWSUPERIOR               102
-
-#define SLAPI_SEARCH_TARGET                    SLAPI_TARGET_DN
-#define SLAPI_SEARCH_SCOPE                     110
-#define SLAPI_SEARCH_DEREF                     111
-#define SLAPI_SEARCH_SIZELIMIT                 112
-#define SLAPI_SEARCH_TIMELIMIT                 113
-#define SLAPI_SEARCH_FILTER                    114
-#define SLAPI_SEARCH_STRFILTER                 115
-#define SLAPI_SEARCH_ATTRS                     116
-#define SLAPI_SEARCH_ATTRSONLY                 117
+/* This is the spelling in the SunOne 5.2 docs */
+#define        SLAPI_RES_CONTROLS      SLAPI_RESCONTROLS
 
 #define SLAPI_ABANDON_MSGID                    120
 
+#define SLAPI_OPERATION_PARAMETERS             138
+
 #define SLAPI_SEQ_TYPE                         150
 #define SLAPI_SEQ_ATTRNAME                     151
 #define SLAPI_SEQ_VAL                          152
 
-#define SLAPI_EXT_OP_REQ_OID                   160
-#define SLAPI_EXT_OP_REQ_VALUE                 161
-#define SLAPI_EXT_OP_RET_OID                   162
-#define SLAPI_EXT_OP_RET_VALUE                 163
-
 #define SLAPI_MR_FILTER_ENTRY                  170     
 #define SLAPI_MR_FILTER_TYPE                   171
 #define SLAPI_MR_FILTER_VALUE                  172
@@ -280,50 +173,33 @@ LDAP_BEGIN_DECL
 
 #define SLAPI_DB2LDIF_PRINTKEY                 183
 
-#define SLAPI_PARENT_TXN                       190
-#define SLAPI_TXN                              191
-
-#define SLAPI_SEARCH_RESULT_SET                        193
-#define        SLAPI_SEARCH_RESULT_ENTRY               194
-#define        SLAPI_NENTRIES                          195
-#define SLAPI_SEARCH_REFERRALS                 196
-
 #define        SLAPI_CHANGENUMBER                      197
 #define        SLAPI_LOG_OPERATION                     198
 
 #define SLAPI_DBSIZE                           199
 
-#define SLAPI_LOG_FATAL                        0
-#define SLAPI_LOG_TRACE                                1
-#define SLAPI_LOG_PACKETS                      2
-#define SLAPI_LOG_ARGS                         3
-#define SLAPI_LOG_CONNS                                4
-#define SLAPI_LOG_BER                          5
-#define SLAPI_LOG_FILTER                       6
-#define SLAPI_LOG_CONFIG                       7
-#define SLAPI_LOG_ACL                          8
-#define SLAPI_LOG_SHELL                                9
-#define SLAPI_LOG_PARSE                                10
-#define SLAPI_LOG_HOUSE                                11
-#define SLAPI_LOG_REPL                         12
-#define SLAPI_LOG_CACHE                                13
-#define SLAPI_LOG_PLUGIN                       14
-
-#define SLAPI_OPERATION_BIND                   0x00000001L
-#define SLAPI_OPERATION_UNBIND                 0x00000002L
-#define SLAPI_OPERATION_SEARCH                 0x00000004L
-#define SLAPI_OPERATION_MODIFY                 0x00000008L
-#define SLAPI_OPERATION_ADD                    0x00000010L
-#define SLAPI_OPERATION_DELETE                 0x00000020L
-#define SLAPI_OPERATION_MODDN                  0x00000040L
-#define SLAPI_OPERATION_MODRDN                 SLAPI_OPERATION_MODDN
-#define SLAPI_OPERATION_COMPARE                0x00000080L
-#define SLAPI_OPERATION_ABANDON                0x00000100L
-#define SLAPI_OPERATION_EXTENDED               0x00000200L
-#define SLAPI_OPERATION_ANY                    0xFFFFFFFFL
-#define SLAPI_OPERATION_NONE                   0x00000000L
+#define        SLAPI_PLUGIN_DB_TEST_FN                 227
+#define SLAPI_PLUGIN_DB_NO_ACL                 250
 
-LDAP_END_DECL
+/* OpenLDAP private parametrs */
+#define SLAPI_PLUGIN_COMPUTE_EVALUATOR_FN      1200
+#define SLAPI_PLUGIN_COMPUTE_SEARCH_REWRITER_FN        1201
 
-#endif /* _SLAPI_H */
+#define SLAPI_X_CONFIG_ARGV                    1400
+#define SLAPI_X_INTOP_FLAGS                    1401
+#define SLAPI_X_INTOP_RESULT_CALLBACK          1402
+#define SLAPI_X_INTOP_SEARCH_ENTRY_CALLBACK    1403
+#define SLAPI_X_INTOP_REFERRAL_ENTRY_CALLBACK  1404
+#define SLAPI_X_INTOP_CALLBACK_DATA            1405
+#define SLAPI_X_OLD_RESCONTROLS                        1406
 
+LDAP_SLAPI_V (ldap_pvt_thread_mutex_t) slapi_hn_mutex;
+LDAP_SLAPI_V (ldap_pvt_thread_mutex_t) slapi_time_mutex;
+LDAP_SLAPI_V (ldap_pvt_thread_mutex_t) slapi_printmessage_mutex; 
+LDAP_SLAPI_V (char *)                  slapi_log_file;
+LDAP_SLAPI_V (int)                     slapi_log_level;
+
+#include "proto-slapi.h"
+
+#endif /* _SLAPI_H */
+#endif /* LDAP_SLAPI */