mirror of
https://git.openldap.org/openldap/openldap.git
synced 2024-12-21 03:10:25 +08:00
Additional updates
This commit is contained in:
parent
c801634137
commit
511d395f1f
@ -8,10 +8,17 @@ ldap_abandon_ext \- Abandon an LDAP operation in progress
|
|||||||
OpenLDAP LDAP (libldap, -lldap)
|
OpenLDAP LDAP (libldap, -lldap)
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.nf
|
.nf
|
||||||
.B #include <ldap.h>
|
.B
|
||||||
.BI "int ldap_abandon_ext(LDAP *" ld ", int " msgid ","
|
#include <ldap.h>
|
||||||
|
.LP
|
||||||
|
.ft B
|
||||||
|
int ldap_abandon_ext(
|
||||||
.RS
|
.RS
|
||||||
.BI "LDAPControl *" sctrls "[], LDAPControl *" cctrls "[]);"
|
.ft B
|
||||||
|
LDAP *\fIld\fB,
|
||||||
|
Bint \fImsgid\fB,
|
||||||
|
LDAPControl **\fIsctrls\fB,
|
||||||
|
LDAPControl **\fIcctrls\fB );
|
||||||
.RE
|
.RE
|
||||||
.fi
|
.fi
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
|
@ -12,30 +12,40 @@ OpenLDAP LDAP (libldap, -lldap)
|
|||||||
#include <ldap.h>
|
#include <ldap.h>
|
||||||
.LP
|
.LP
|
||||||
.ft B
|
.ft B
|
||||||
.nf
|
int ldap_modify_ext(
|
||||||
int ldap_modify(ld, dn, mods)
|
.RS
|
||||||
.ft
|
|
||||||
LDAP *ld;
|
|
||||||
char *dn;
|
|
||||||
LDAPMod *mods[];
|
|
||||||
.LP
|
|
||||||
.ft B
|
.ft B
|
||||||
.nf
|
LDAP *\fIld\fB,
|
||||||
int ldap_modify_s(ld, dn, mods)
|
char *\fIdn\fB,
|
||||||
.ft
|
LDAPMod *\fImods[]\fB,
|
||||||
LDAP *ld;
|
LDAPControl **\fIsctrls\fB,
|
||||||
char *dn;
|
LDAPControl **\fIcctrls\fB,
|
||||||
LDAPMod *mods[];
|
int **\fImsgidp\fB );
|
||||||
|
.RE
|
||||||
.LP
|
.LP
|
||||||
.ft B
|
|
||||||
.nf
|
.nf
|
||||||
void ldap_mods_free( mods, freemods )
|
.ft B
|
||||||
.ft
|
int ldap_modify_ext_s(
|
||||||
LDAPMod **mods;
|
.RS
|
||||||
int freemods;
|
.ft B
|
||||||
|
LDAP *\fIld\fB,
|
||||||
|
char *\fIdn\fB,
|
||||||
|
LDAPMod *\fImods[]\fB,
|
||||||
|
LDAPControl **\fIsctrls\fB,
|
||||||
|
LDAPControl **\fIcctrls\fB );
|
||||||
|
.RE
|
||||||
|
.LP
|
||||||
|
.nf
|
||||||
|
.ft B
|
||||||
|
void ldap_mods_free(
|
||||||
|
.RS
|
||||||
|
.ft B
|
||||||
|
LDAPMod **\fImods\fB,
|
||||||
|
int \fIfreemods\fB );
|
||||||
|
.RE
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The routine
|
The routine
|
||||||
.B ldap_modify_s()
|
.B ldap_modify_ext_s()
|
||||||
is used to perform an LDAP modify operation.
|
is used to perform an LDAP modify operation.
|
||||||
\fIdn\fP is the DN of the entry to modify, and \fImods\fP is a
|
\fIdn\fP is the DN of the entry to modify, and \fImods\fP is a
|
||||||
null-terminated array of modifications to make to the entry. Each element
|
null-terminated array of modifications to make to the entry. Each element
|
||||||
@ -43,7 +53,6 @@ of the \fImods\fP array is a pointer to an LDAPMod structure, which is
|
|||||||
defined below.
|
defined below.
|
||||||
.LP
|
.LP
|
||||||
.nf
|
.nf
|
||||||
.ft B
|
|
||||||
typedef struct ldapmod {
|
typedef struct ldapmod {
|
||||||
int mod_op;
|
int mod_op;
|
||||||
char *mod_type;
|
char *mod_type;
|
||||||
@ -82,20 +91,24 @@ modifications, the attribute will have the listed values after the
|
|||||||
modification, having been created if necessary. All modifications are
|
modification, having been created if necessary. All modifications are
|
||||||
performed in the order in which they are listed.
|
performed in the order in which they are listed.
|
||||||
.LP
|
.LP
|
||||||
.B
|
.B ldap_modify_ext_s()
|
||||||
ldap_modify_s()
|
|
||||||
returns the LDAP error code resulting from the
|
returns the LDAP error code resulting from the
|
||||||
modify operation. This code can be interpreted by
|
modify operation.
|
||||||
.BR ldap_perror (3)
|
.LP
|
||||||
and friends.
|
Both
|
||||||
|
.B ldap_abandon_ext()
|
||||||
|
and
|
||||||
|
.B ldap_abandon_ext()
|
||||||
|
allows server and client controls to be passed in
|
||||||
|
via the sctrls and cctrls parameters, respectively.
|
||||||
.LP
|
.LP
|
||||||
The
|
The
|
||||||
.B ldap_modify()
|
.B ldap_modify_ext()
|
||||||
operation works the same way as
|
operation works the same way as
|
||||||
.BR ldap_modify_s() ,
|
.BR ldap_modify_ext_s() ,
|
||||||
except that it is asynchronous, returning the message id of the
|
except that it is asynchronous. The integer that \fImsgidp\fP points
|
||||||
request it initiates, or -1 on error. The result of the operation
|
to is set to the message id of the modify request. The result of
|
||||||
can be obtained by calling
|
the operation can be obtained by calling
|
||||||
.BR ldap_result (3).
|
.BR ldap_result (3).
|
||||||
.LP
|
.LP
|
||||||
.B ldap_mods_free()
|
.B ldap_mods_free()
|
||||||
@ -103,20 +116,30 @@ can be used to free each element of a NULL-terminated
|
|||||||
array of mod structures. If \fIfreemods\fP is non-zero, the
|
array of mod structures. If \fIfreemods\fP is non-zero, the
|
||||||
\fImods\fP pointer itself is freed as well.
|
\fImods\fP pointer itself is freed as well.
|
||||||
.SH ERRORS
|
.SH ERRORS
|
||||||
.B ldap_modify_s()
|
.B ldap_modify_ext_s()
|
||||||
|
and
|
||||||
|
.B ldap_modify_ext()
|
||||||
returns an ldap error code, either LDAP_SUCCESS or
|
returns an ldap error code, either LDAP_SUCCESS or
|
||||||
an error if there was trouble.
|
an error if there was trouble.
|
||||||
|
|
||||||
|
See
|
||||||
|
.BR ldap_error (3)
|
||||||
|
for details
|
||||||
|
.SH DEPRECATED INTERFACES
|
||||||
|
The
|
||||||
.B ldap_modify()
|
.B ldap_modify()
|
||||||
returns -1 in case
|
and
|
||||||
of trouble, setting the
|
.B ldap_modify_s()
|
||||||
.B ld_errno
|
routines are deprecated in favor of the
|
||||||
field of \fIld\fP.
|
.B ldap_modify_ext()
|
||||||
|
and
|
||||||
|
.B ldap_modify_ext_s()
|
||||||
|
routines, respectively.
|
||||||
|
|
||||||
|
.so Deprecated
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.BR ldap (3),
|
.BR ldap (3),
|
||||||
.BR ldap_error (3),
|
.BR ldap_error (3),
|
||||||
.BR ldap_add (3)
|
|
||||||
.SH ACKNOWLEDGEMENTS
|
.SH ACKNOWLEDGEMENTS
|
||||||
.B OpenLDAP
|
.so ../Project
|
||||||
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
|
|
||||||
.B OpenLDAP
|
|
||||||
is derived from University of Michigan LDAP 3.3 Release.
|
|
||||||
|
Loading…
Reference in New Issue
Block a user