2002-06-13 11:59:10 +08:00
|
|
|
.TH LDAP_MODRDN 3 "RELEASEDATE" "OpenLDAP LDVERSION"
|
1999-09-12 12:41:47 +08:00
|
|
|
.\" $OpenLDAP$
|
2004-01-02 03:15:16 +08:00
|
|
|
.\" Copyright 1998-2004 The OpenLDAP Foundation All Rights Reserved.
|
1999-09-12 12:41:47 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH NAME
|
|
|
|
|
ldap_modrdn, ldap_modrdn_s, ldap_modrdn2, ldap_modrdn2_s \- Perform an LDAP modify RDN operation
|
2002-06-21 15:32:54 +08:00
|
|
|
.SH LIBRARY
|
2002-06-22 05:25:38 +08:00
|
|
|
OpenLDAP LDAP (libldap, -lldap)
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.nf
|
|
|
|
|
.ft B
|
|
|
|
|
#include <ldap.h>
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
int ldap_modrdn(ld, dn, newrdn)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP \(**ld;
|
|
|
|
|
char \(**dn, \(**newrdn;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
int ldap_modrdn_s(ld, dn, newrdn)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP \(**ld;
|
|
|
|
|
char \(**dn, \(**newrdn;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
int ldap_modrdn2(ld, dn, newrdn, deleteoldrdn)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP \(**ld;
|
|
|
|
|
char \(**dn, \(**newrdn;
|
|
|
|
|
int deleteoldrdn;
|
|
|
|
|
.LP
|
|
|
|
|
.ft B
|
|
|
|
|
int ldap_modrdn2_s(ld, dn, newrdn, deleteoldrdn)
|
|
|
|
|
.ft
|
|
|
|
|
LDAP \(**ld;
|
|
|
|
|
char \(**dn, \(**newrdn;
|
|
|
|
|
int deleteoldrdn;
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.B ldap_modrdn()
|
|
|
|
|
and
|
|
|
|
|
.B ldap_modrdn_s()
|
|
|
|
|
routines perform an LDAP modify
|
|
|
|
|
RDN operation. They both take \fIdn\fP, the DN of the entry whose
|
|
|
|
|
RDN is to be changed, and \fInewrdn\fP, the new RDN to give the entry.
|
|
|
|
|
The old RDN of the entry is never kept as an attribute of the entry.
|
|
|
|
|
.B ldap_modrdn()
|
|
|
|
|
is asynchronous, returning the message id of the operation
|
|
|
|
|
it initiates.
|
|
|
|
|
.B ldap_modrdn_s()
|
|
|
|
|
is synchronous, returning the LDAP error
|
|
|
|
|
code indicating the success or failure of the operation. Use of
|
|
|
|
|
these routines is deprecated. Use the versions described below
|
|
|
|
|
instead.
|
|
|
|
|
.LP
|
|
|
|
|
The
|
|
|
|
|
.B ldap_modrdn2()
|
|
|
|
|
and
|
|
|
|
|
.B ldap_modrdn2_s()
|
|
|
|
|
routines also perform an LDAP
|
|
|
|
|
modify RDN operation, taking the same parameters as above. In addition,
|
|
|
|
|
they both take the \fIdeleteoldrdn\fP parameter which is used as a boolean
|
|
|
|
|
value to indicate whether the old RDN values should be deleted from
|
|
|
|
|
the entry or not.
|
|
|
|
|
.SH ERRORS
|
|
|
|
|
The synchronous (_s) versions of these routines return an LDAP error
|
|
|
|
|
code, either LDAP_SUCCESS or an error if there was trouble.
|
|
|
|
|
The asynchronous versions return -1 in case
|
|
|
|
|
of trouble, setting the
|
|
|
|
|
.B ld_errno
|
|
|
|
|
field of \fIld\fP. See
|
|
|
|
|
.BR ldap_error (3)
|
|
|
|
|
for more details.
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR ldap (3),
|
|
|
|
|
.BR ldap_error (3)
|
1998-10-25 09:41:42 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
2003-06-29 23:34:32 +08:00
|
|
|
.B OpenLDAP
|
1998-10-25 09:41:42 +08:00
|
|
|
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
|
2003-06-29 23:34:32 +08:00
|
|
|
.B OpenLDAP
|
1998-10-25 09:41:42 +08:00
|
|
|
is derived from University of Michigan LDAP 3.3 Release.
|
