]> git.sur5r.net Git - openldap/blobdiff - include/ldap.h
Update configure to:
[openldap] / include / ldap.h
index 16c33432c89bc9adba1fa92af66013e577d34047..cbd7575574e3ab08d8c1e4fe58c11138394f1e09 100644 (file)
@@ -1,4 +1,13 @@
 /*
+ * Copyright 1998,1999 The OpenLDAP Foundation, Redwood City, California, USA
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms are permitted only
+ * as authorized by the OpenLDAP Public License.  A copy of this
+ * license is available at http://www.OpenLDAP.org/license.html or
+ * in file LICENSE in the top-level directory of the distribution.
+ */
+/* Portions
  * Copyright (c) 1990 Regents of the University of Michigan.
  * All rights reserved.
  *
@@ -35,6 +44,9 @@ LDAP_BEGIN_DECL
 /* We'll eventually release as 200 */
 #define LDAP_VENDOR_VERSION    190
 
+/* OpenLDAP API Features */
+#define LDAP_API_FEATURE_X_OPENLDAP 1
+
 /* include LDAP_API_FEATURE defines */
 #include <ldap_features.h>
 
@@ -133,6 +145,23 @@ typedef struct ldapcontrol {
 #define LDAP_TAG_MSGID         0x02L
 /* need to add other LDAP_TAGs here */
 
+/* Overview of tag construction in ASN.1:
+ *      _______
+ * Bit # | 8 7 | CLASS: UNIVERSAL              00
+ *                     APPLICATION             01
+ *                     CONTEXT-SPECIFIC        10
+ *                     PRIVATE                 11
+ *             _____
+ *             | 6 | DATA-TYPE: PRIMITIVE      0
+ *                              CONSTRUCTED    1
+ *                 ___________
+ *                 | 5 ... 1 | TAG-NUMBER
+ */
+#define LDAP_TAG_NEWSUPERIOR   0x80L   /* context-specific + primitive +
+                                        * tag # ==> [0]
+                                        */
+
 /* possible operations a client can invoke */
 #define LDAP_REQ_BIND                  0x60L   /* application + constructed */
 #define LDAP_REQ_UNBIND                        0x42L   /* application + primitive   */
@@ -192,6 +221,9 @@ typedef struct ldapcontrol {
 #define OLD_LDAP_RES_MODDN             OLD_LDAP_RES_MODRDN
 #define OLD_LDAP_RES_COMPARE           0x0fL
 
+/* sasl methods */
+#define LDAP_SASL_SIMPLE                       NULL
+
 /* authentication methods available */
 #define LDAP_AUTH_NONE         0x00L   /* no authentication              */
 #define LDAP_AUTH_SIMPLE       0x80L   /* context specific + primitive   */
@@ -428,13 +460,6 @@ typedef struct ldap_friendly {
        char    *lf_friendly;
 } LDAPFriendlyMap;
 
-
-/*
- * handy macro to check whether LDAP struct is set up for CLDAP or not
- */
-#define LDAP_IS_CLDAP( ld )    ( (ld)->ld_sb.sb_naddr > 0 )
-
-
 /*
  * types for ldap URL handling
  */
@@ -463,23 +488,93 @@ struct timeval;
 LDAP_F int ldap_get_option LDAP_P((LDAP *ld, int option, void *outvalue));
 LDAP_F int ldap_set_option LDAP_P((LDAP *ld, int option, void *invalue));
 
-/* in controls.c */
+
+/*
+ * in controls.c:
+ */
 LDAP_F void ldap_control_free LDAP_P(( LDAPControl *ctrl ));
 LDAP_F void ldap_controls_free LDAP_P(( LDAPControl **ctrls ));
+
   
+/*
+ * in extended.c:
+ */
+LDAP_F int ldap_extended_operation LDAP_P((
+       LDAP                    *ld,
+       char                    *exoid,
+       struct berval   *exdata,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                             *msgidp ));
+
+LDAP_F int ldap_extended_operation_s LDAP_P((
+       LDAP                    *ld,
+       char                    *exoid,
+       struct berval   *exdata,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       char                    **retoidp,
+       struct berval   **retdatap ));
+
 /*
  * in abandon.c:
  */
 LDAP_F int ldap_abandon LDAP_P(( LDAP *ld, int msgid ));
+LDAP_F int ldap_abandon_ext LDAP_P((
+       LDAP                    *ld,
+       int                             msgid,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls ));
+
 
 /*
  * in add.c:
  */
+LDAP_F int ldap_add_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPMod                 **attrs,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                     *msgidp ));
+
+LDAP_F int ldap_add_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPMod                 **attrs,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       LDAPMessage     **res ));
+
 LDAP_F int ldap_add LDAP_P(( LDAP *ld, char *dn, LDAPMod **attrs ));
 LDAP_F int ldap_add_s LDAP_P(( LDAP *ld, char *dn, LDAPMod **attrs ));
 
+
+/*
+ * in saslbind.c:
+ */
+LDAP_F int ldap_sasl_bind LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *mechanism,
+       struct berval *cred,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                             msgidp ));
+
+LDAP_F int ldap_sasl_bind_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *mechanism,
+       struct berval   *cred,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       struct berval   **servercredp ));
+
+
 /*
  * in bind.c:
+ *     (depreciated)
  */
 LDAP_F int ldap_bind LDAP_P(( LDAP *ld, char *who, char *passwd, int authmethod ));
 LDAP_F int ldap_bind_s LDAP_P(( LDAP *ld, char *who, char *cred, int method ));
@@ -487,14 +582,17 @@ LDAP_F void ldap_set_rebind_proc LDAP_P(( LDAP *ld,
        int (*rebindproc) LDAP_P(( LDAP *ld, char **dnp, char **passwdp, int *authmethodp, int freeit ))
 ));
 
+
 /*
  * in sbind.c:
  */
 LDAP_F int ldap_simple_bind LDAP_P(( LDAP *ld, char *who, char *passwd ));
 LDAP_F int ldap_simple_bind_s LDAP_P(( LDAP *ld, char *who, char *passwd ));
 
+
 /*
  * in kbind.c:
+ *     (depreciated)
  */
 LDAP_F int ldap_kerberos_bind_s LDAP_P(( LDAP *ld, char *who ));
 LDAP_F int ldap_kerberos_bind1 LDAP_P(( LDAP *ld, char *who ));
@@ -514,18 +612,53 @@ LDAP_F void ldap_flush_cache LDAP_P(( LDAP *ld ));
 LDAP_F void ldap_uncache_entry LDAP_P(( LDAP *ld, char *dn ));
 LDAP_F void ldap_uncache_request LDAP_P(( LDAP *ld, int msgid ));
 
+
 /*
  * in compare.c:
  */
+LDAP_F int ldap_compare_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *attr,
+       struct berval   *bvalue,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                     *msgidp ));
+
+LDAP_F int ldap_compare_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *attr,
+       struct berval   *bvalue,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       LDAPMessage     **res ));
+
 LDAP_F int ldap_compare LDAP_P(( LDAP *ld, char *dn, char *attr, char *value ));
 LDAP_F int ldap_compare_s LDAP_P(( LDAP *ld, char *dn, char *attr, char *value ));
 
+
 /*
  * in delete.c:
  */
+LDAP_F int ldap_delete_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                     *msgidp ));
+
+LDAP_F int ldap_delete_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       LDAPMessage     **res ));
+
 LDAP_F int ldap_delete LDAP_P(( LDAP *ld, char *dn ));
 LDAP_F int ldap_delete_s LDAP_P(( LDAP *ld, char *dn ));
 
+
 /*
  * in error.c:
  */
@@ -533,12 +666,54 @@ LDAP_F int ldap_result2error LDAP_P(( LDAP *ld, LDAPMessage *r, int freeit ));
 LDAP_F char *ldap_err2string LDAP_P(( int err ));
 LDAP_F void ldap_perror LDAP_P(( LDAP *ld, char *s ));
 
+
 /*
  * in modify.c:
  */
+LDAP_F int ldap_modify_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPMod                 **mods,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                     *msgidp ));
+
+LDAP_F int ldap_modify_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       LDAPMod                 **mods,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       LDAPMessage     **res ));
+
 LDAP_F int ldap_modify LDAP_P(( LDAP *ld, char *dn, LDAPMod **mods ));
 LDAP_F int ldap_modify_s LDAP_P(( LDAP *ld, char *dn, LDAPMod **mods ));
 
+
+/*
+ * in rename.c:
+ */
+LDAP_F int ldap_rename_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *newrdn,
+       char                    *newparent,
+       int                             deleteoldrdn,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       int                     *msgidp ));
+
+LDAP_F int ldap_rename_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *dn,
+       char                    *newrdn,
+       char                    *newparent,
+       int                             deleteoldrdn,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       LDAPMessage     **res ));
+
+
 /*
  * in modrdn.c:
  */
@@ -548,12 +723,39 @@ LDAP_F int ldap_modrdn2 LDAP_P(( LDAP *ld, char *dn, char *newrdn,
        int deleteoldrdn ));
 LDAP_F int ldap_modrdn2_s LDAP_P(( LDAP *ld, char *dn, char *newrdn,
        int deleteoldrdn));
+LDAP_F int ldap_rename2 LDAP_P(( LDAP *ld, char *dn, char *newrdn,
+       int deleteoldrdn, char *newSuperior ));
+LDAP_F int ldap_rename2_s LDAP_P(( LDAP *ld, char *dn, char *newrdn,
+       int deleteoldrdn, char *newSuperior));
 
 /*
  * in open.c:
  */
 LDAP_F LDAP *ldap_open LDAP_P(( char *host, int port ));
-LDAP_F LDAP *ldap_init LDAP_P(( char *defhost, int defport ));
+LDAP_F LDAP *ldap_init LDAP_P(( char *host, int port ));
+
+
+/*
+ * in messages.c:
+ */
+LDAP_F LDAPMessage *ldap_first_message LDAP_P(( LDAP *ld, LDAPMessage *chain ));
+LDAP_F LDAPMessage *ldap_next_message LDAP_P(( LDAP *ld, LDAPMessage *msg ));
+LDAP_F int ldap_count_messages LDAP_P(( LDAP *ld, LDAPMessage *chain ));
+
+
+/*
+ * in references.c:
+ */
+LDAP_F LDAPMessage *ldap_first_reference LDAP_P(( LDAP *ld, LDAPMessage *chain ));
+LDAP_F LDAPMessage *ldap_next_reference LDAP_P(( LDAP *ld, LDAPMessage *ref ));
+LDAP_F int ldap_count_references LDAP_P(( LDAP *ld, LDAPMessage *chain ));
+LDAP_F int ldap_parse_reference LDAP_P((
+       LDAP                    *ld,
+       LDAPMessage             *ref,
+       char                    ***referralsp,
+       LDAPControl             ***serverctrls,
+       int                             freeit));
+
 
 /*
  * in getentry.c:
@@ -561,6 +763,11 @@ LDAP_F LDAP *ldap_init LDAP_P(( char *defhost, int defport ));
 LDAP_F LDAPMessage *ldap_first_entry LDAP_P(( LDAP *ld, LDAPMessage *chain ));
 LDAP_F LDAPMessage *ldap_next_entry LDAP_P(( LDAP *ld, LDAPMessage *entry ));
 LDAP_F int ldap_count_entries LDAP_P(( LDAP *ld, LDAPMessage *chain ));
+LDAP_F int ldap_get_entry_controls LDAP_P((
+       LDAP                    *ld,
+       LDAPMessage             *entry,
+       LDAPControl             ***serverctrls));
+
 
 /*
  * in addentry.c
@@ -569,6 +776,7 @@ LDAP_F LDAPMessage *ldap_delete_result_entry LDAP_P(( LDAPMessage **list,
        LDAPMessage *e ));
 LDAP_F void ldap_add_result_entry LDAP_P(( LDAPMessage **list, LDAPMessage *e ));
 
+
 /*
  * in getdn.c
  */
@@ -579,6 +787,7 @@ LDAP_F char **ldap_explode_rdn LDAP_P(( char *rdn, int notypes ));
 LDAP_F char **ldap_explode_dns LDAP_P(( char *dn ));
 LDAP_F int ldap_is_dns_dn LDAP_P(( char *dn ));
 
+
 /*
  * in getattr.c
  */
@@ -587,6 +796,7 @@ LDAP_F char *ldap_first_attribute LDAP_P(( LDAP *ld, LDAPMessage *entry,
 LDAP_F char *ldap_next_attribute LDAP_P(( LDAP *ld, LDAPMessage *entry,
        BerElement *ber ));
 
+
 /*
  * in getvalues.c
  */
@@ -598,6 +808,7 @@ LDAP_F int ldap_count_values_len LDAP_P(( struct berval **vals ));
 LDAP_F void ldap_value_free LDAP_P(( char **vals ));
 LDAP_F void ldap_value_free_len LDAP_P(( struct berval **vals ));
 
+
 /*
  * in result.c:
  */
@@ -608,9 +819,34 @@ LDAP_F int ldap_msgid   LDAP_P(( LDAPMessage *lm ));
 LDAP_F int ldap_msgfree LDAP_P(( LDAPMessage *lm ));
 LDAP_F int ldap_msgdelete LDAP_P(( LDAP *ld, int msgid ));
 
+
 /*
  * in search.c:
  */
+LDAP_F int ldap_search_ext LDAP_P((
+       LDAP                    *ld,
+       char                    *base,
+       int                             scope,
+       char                    *filter,
+       char                    **attrs,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       struct timeval  *timeout,
+       int                             sizelimit,
+       int                             *msgidp ));
+
+LDAP_F int ldap_search_ext_s LDAP_P((
+       LDAP                    *ld,
+       char                    *base,
+       int                             scope,
+       char                    *filter,
+       char                    **attrs,
+       LDAPControl             **serverctrls,
+       LDAPControl             **clientctrls,
+       struct timeval  *timeout,
+       int                             sizelimit,
+       LDAPMessage             **res ));
+
 LDAP_F int ldap_search LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
        char **attrs, int attrsonly ));
 LDAP_F int ldap_search_s LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
@@ -618,6 +854,7 @@ LDAP_F int ldap_search_s LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
 LDAP_F int ldap_search_st LDAP_P(( LDAP *ld, char *base, int scope, char *filter,
     char **attrs, int attrsonly, struct timeval *timeout, LDAPMessage **res ));
 
+
 /*
  * in ufn.c
  */
@@ -654,12 +891,15 @@ LDAP_F void ldap_build_filter LDAP_P(( char *buf, unsigned long buflen,
        char *pattern, char *prefix, char *suffix, char *attr,
        char *value, char **valwords ));
 
+
 /*
  * in free.c
  */
+LDAP_F void ldap_memfree LDAP_P(( void *p ));
 LDAP_F void ldap_getfilter_free LDAP_P(( LDAPFiltDesc *lfdp ));
 LDAP_F void ldap_mods_free LDAP_P(( LDAPMod **mods, int freemods ));
 
+
 /*
  * in friendly.c
  */
@@ -719,12 +959,6 @@ LDAP_F int ldap_t61_to_8859 LDAP_P(( char **bufp, unsigned long *buflenp,
 LDAP_F int ldap_8859_to_t61 LDAP_P(( char **bufp, unsigned long *buflenp,
        int free_input ));
 
-
-/*
- * in msdos/winsock/wsa.c
- */
-LDAP_F void ldap_memfree LDAP_P(( void *p ));
-
 LDAP_END_DECL
 
 #endif /* _LDAP_H */