[openldap] / servers / slapd / slapi / slapi.h

/*
 * Copyright 1998-2003 The OpenLDAP Foundation, All Rights Reserved.
 * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
 */
/*
 * (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.
 */

#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 struct  slap_attr *     Slapi_AttrSet;
typedef struct  berval          Slapi_Value;
typedef BerVarray               Slapi_ValueSet;
typedef Filter                  Slapi_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 */

LDAP_BEGIN_DECL

/*
 * Attribute flags returned by slapi_attr_get_flags()
 */
#define SLAPI_ATTR_FLAG_SINGLE          0x0001
#define SLAPI_ATTR_FLAG_OPATTR          0x0002
#define SLAPI_ATTR_FLAG_READONLY        0x0004
#define SLAPI_ATTR_FLAG_STD_ATTR        SLAPI_ATTR_FLAG_READONLY
#define SLAPI_ATTR_FLAG_OBSOLETE        0x0040
#define SLAPI_ATTR_FLAG_COLLECTIVE      0x0080
#define SLAPI_ATTR_FLAG_NOUSERMOD       0x0100

/*
 * ACL levels
 */
#define SLAPI_ACL_COMPARE       0x01
#define SLAPI_ACL_SEARCH        0x02
#define SLAPI_ACL_READ          0x04
#define SLAPI_ACL_WRITE         0x08
#define SLAPI_ACL_DELETE        0x10
#define SLAPI_ACL_ADD           0x20
#define SLAPI_ACL_SELF          0x40
#define SLAPI_ACL_PROXY         0x80
#define SLAPI_ACL_ALL           0x7f

/*
 * Plugin types universally supported by SLAPI
 * implementations
 */
#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
/*
 * The following plugin types are reserved for future
 * Sun ONE DS compatability.
 */
#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
/*
 * Because the Sun ONE DS virtual attribute service
 * is quite complicated, we've added a "lightweight"
 * virtual attribute service. Virtual attribute
 * plugins are called for each search result; 
 * they should examine the list of attributes
 * requested to minimise the performance impact.
 */
#define SLAPI_PLUGIN_OPATTR_SP                  17

#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_OPERATION_PARAMETERS              138
#define SLAPI_CONN_ID                           139

#define SLAPI_OPINITIATED_TIME                  140
#define SLAPI_REQUESTOR_DN                      141
#define SLAPI_REQUESTOR_ISUPDATEDN              142
#define SLAPI_IS_REPLICATED_OPERATION           SLAPI_REQUESTOR_ISUPDATEDN
#define SLAPI_CONN_DN                           143
#define SLAPI_CONN_CLIENTIP                     145
#define SLAPI_CONN_SERVERIP                     146
#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_OPERATION_TYPE                    590

#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_OPERATION_AUTHTYPE                741
#define SLAPI_OPERATION_ID                      742
#define SLAPI_CONN_CERT                         743
#define SLAPI_CONN_AUTHMETHOD                   746

#define SLAPI_RESULT_CODE                       881
#define SLAPI_RESULT_TEXT                       882
#define SLAPI_RESULT_MATCHED                    883

/* Virtual attribute service provider */
#define SLAPI_PLUGIN_OPATTR_COALESCE_DATA       900
/* Pointer to a Slapi_AttrSet */
#define SLAPI_PLUGIN_OPATTR_COALESCE_FN         901

#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_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

#define SLAPI_ABANDON_MSGID                     120

#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
#define SLAPI_MR_FILTER_OID                     173
#define SLAPI_MR_FILTER_DNATTRS                 174

#define SLAPI_LDIF2DB_FILE                      180
#define SLAPI_LDIF2DB_REMOVEDUPVALS             185

#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

LDAP_END_DECL

#endif /* _SLAPI_H */