1 .TH LDAP_ADD 3 "RELEASEDATE" "OpenLDAP LDVERSION"
3 .\" Copyright 1998-2002 The OpenLDAP Foundation All Rights Reserved.
4 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 ldap_add, ldap_add_s, ldap_add_ext, ldap_add_ext_s \- Perform an LDAP add operation
11 .BI "int ldap_add(LDAP *" ld ", const char *" dn ", LDAPMOD *" attrs "[]);"
13 .BI "int ldap_add_s(LDAP *" ld ", const char *" dn ", LDAPMod *" attrs "[]);"
15 .BI "int ldap_add_ext(LDAP *" ld ", const char *" dn ", LDAPMOD *" attrs "[],"
17 .BI "LDAPControl *" sctrls "[], LDAPControl *" cctrls "[], int *" msgidp ");"
20 .BI "int ldap_add_ext_s(LDAP *" ld ", const char *" dn ", LDAPMOD *" attrs "[],"
22 .BI "LDAPControl *" sctrls "[], LDAPControl *" cctrls "[]);"
28 routine is used to perform an LDAP add operation.
29 It takes \fIdn\fP, the DN of the entry to add, and \fIattrs\fP, a
30 null-terminated array of the entry's attributes. The LDAPMod structure
31 is used to represent attributes, with the \fImod_type\fP and
32 \fImod_values\fP fields being used as described under
34 and the \fIldap_op\fP field being used only if you need to specify
35 the LDAP_MOD_BVALUES option. Otherwise, it should be set to zero.
37 Note that all entries except that
38 specified by the last component in the given DN must already exist.
40 returns an LDAP error code indicating success or failure
47 routine works just like
49 but it is asynchronous. It returns the message id of the request it
50 initiated. The result of this operation can be obtained by calling
55 routine allows server and client controls to be specified to extend
56 the add request. This routine is asynchronous like
58 but its return value is an LDAP error code. It stores the message id
59 of the request in the integer pointed to
65 routine is the synchronous version of
67 It also returns an LDAP error code indicating success or failure
71 returns -1 in case of error initiating the request, and
72 will set the \fIld_errno\fP field in the \fIld\fP parameter
73 to indicate the error.
75 will return an LDAP error code
76 directly (LDAP_SUCCESS if everything went ok, some error otherwise).
80 also directly return LDAP error codes.
86 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
88 is derived from University of Michigan LDAP 3.3 Release.