1 /* $OpenLDAP: pkg/ldap/libraries/libldap/modrdn.c,v 1.30.2.3 2008/02/11 23:26:41 kurt Exp $ */
2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2008 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in the file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
15 /* Portions Copyright (c) 1990 Regents of the University of Michigan.
16 * All rights reserved.
18 /* Copyright 1999, Juan C. Gomez, All rights reserved.
19 * This software is not subject to any license of Silicon Graphics
20 * Inc. or Purdue University.
22 * Redistribution and use in source and binary forms are permitted
23 * without restriction or fee of any kind as long as this notice
35 #include <ac/socket.h>
36 #include <ac/string.h>
42 * A modify rdn request looks like this:
43 * ModifyRDNRequest ::= SEQUENCE {
44 * entry DistinguishedName,
45 * newrdn RelativeDistinguishedName,
46 * deleteoldrdn BOOLEAN
47 * newSuperior [0] DistinguishedName [v3 only]
53 * ldap_rename - initiate an ldap extended modifyDN operation.
57 * dn DN of the object to modify
58 * newrdn RDN to give the object
59 * deleteoldrdn nonzero means to delete old rdn values from the entry
60 * newSuperior DN of the new parent if applicable
62 * Returns the LDAP error code.
69 LDAP_CONST
char *newrdn
,
70 LDAP_CONST
char *newSuperior
,
80 Debug( LDAP_DEBUG_TRACE
, "ldap_rename\n", 0, 0, 0 );
82 /* check client controls */
83 rc
= ldap_int_client_controls( ld
, cctrls
);
84 if( rc
!= LDAP_SUCCESS
) return rc
;
86 /* create a message to send */
87 if ( (ber
= ldap_alloc_ber_with_options( ld
)) == NULL
) {
88 return( LDAP_NO_MEMORY
);
91 LDAP_NEXT_MSGID( ld
, id
);
92 if( newSuperior
!= NULL
) {
93 /* must be version 3 (or greater) */
94 if ( ld
->ld_version
< LDAP_VERSION3
) {
95 ld
->ld_errno
= LDAP_NOT_SUPPORTED
;
97 return( ld
->ld_errno
);
99 rc
= ber_printf( ber
, "{it{ssbtsN}", /* '}' */
101 dn
, newrdn
, (ber_int_t
) deleteoldrdn
,
102 LDAP_TAG_NEWSUPERIOR
, newSuperior
);
105 rc
= ber_printf( ber
, "{it{ssbN}", /* '}' */
107 dn
, newrdn
, (ber_int_t
) deleteoldrdn
);
111 ld
->ld_errno
= LDAP_ENCODING_ERROR
;
113 return( ld
->ld_errno
);
116 /* Put Server Controls */
117 if( ldap_int_put_controls( ld
, sctrls
, ber
) != LDAP_SUCCESS
) {
122 rc
= ber_printf( ber
, /*{*/ "N}" );
124 ld
->ld_errno
= LDAP_ENCODING_ERROR
;
126 return( ld
->ld_errno
);
129 /* send the message */
130 *msgidp
= ldap_send_initial_request( ld
, LDAP_REQ_MODRDN
, dn
, ber
, id
);
133 return( ld
->ld_errno
);
141 * ldap_rename2 - initiate an ldap (and X.500) modifyDN operation. Parameters:
142 * (LDAP V3 MODIFYDN REQUEST)
144 * dn DN of the object to modify
145 * newrdn RDN to give the object
146 * deleteoldrdn nonzero means to delete old rdn values from the entry
147 * newSuperior DN of the new parent if applicable
149 * ldap_rename2 uses a U-Mich Style API. It returns the msgid.
156 LDAP_CONST
char *newrdn
,
157 LDAP_CONST
char *newSuperior
,
163 Debug( LDAP_DEBUG_TRACE
, "ldap_rename2\n", 0, 0, 0 );
165 rc
= ldap_rename( ld
, dn
, newrdn
, newSuperior
,
166 deleteoldrdn
, NULL
, NULL
, &msgid
);
168 return rc
== LDAP_SUCCESS
? msgid
: -1;
173 * ldap_modrdn2 - initiate an ldap modifyRDN operation. Parameters:
176 * dn DN of the object to modify
177 * newrdn RDN to give the object
178 * deleteoldrdn nonzero means to delete old rdn values from the entry
181 * msgid = ldap_modrdn( ld, dn, newrdn );
184 ldap_modrdn2( LDAP
*ld
,
186 LDAP_CONST
char *newrdn
,
189 return ldap_rename2( ld
, dn
, newrdn
, NULL
, deleteoldrdn
);
193 ldap_modrdn( LDAP
*ld
, LDAP_CONST
char *dn
, LDAP_CONST
char *newrdn
)
195 return( ldap_rename2( ld
, dn
, newrdn
, NULL
, 1 ) );
203 LDAP_CONST
char *newrdn
,
204 LDAP_CONST
char *newSuperior
,
206 LDAPControl
**sctrls
,
207 LDAPControl
**cctrls
)
213 rc
= ldap_rename( ld
, dn
, newrdn
, newSuperior
,
214 deleteoldrdn
, sctrls
, cctrls
, &msgid
);
216 if( rc
!= LDAP_SUCCESS
) {
220 rc
= ldap_result( ld
, msgid
, LDAP_MSG_ALL
, NULL
, &res
);
222 if( rc
== -1 || !res
) {
226 return ldap_result2error( ld
, res
, 1 );
233 LDAP_CONST
char *newrdn
,
234 LDAP_CONST
char *newSuperior
,
237 return ldap_rename_s( ld
, dn
, newrdn
, newSuperior
,
238 deleteoldrdn
, NULL
, NULL
);
242 ldap_modrdn2_s( LDAP
*ld
, LDAP_CONST
char *dn
, LDAP_CONST
char *newrdn
, int deleteoldrdn
)
244 return ldap_rename_s( ld
, dn
, newrdn
, NULL
, deleteoldrdn
, NULL
, NULL
);
248 ldap_modrdn_s( LDAP
*ld
, LDAP_CONST
char *dn
, LDAP_CONST
char *newrdn
)
250 return ldap_rename_s( ld
, dn
, newrdn
, NULL
, 1, NULL
, NULL
);