ldap_merge_partitions

Joins a parent and child partition.

LDAP Version:v3

Library:*ldapx.*

NDS Version:8.5

Platform:NLM, Windows (NT, 95, 98, 2000, XP, Vista 32-bit and 64-bit ), Linux (32-bit and 64-bit), Solaris, AIX, and HP-UX

Syntax

  #include <ldapx.h>
  
  int ldap_merge_partitions (
     LDAP   *ld, 
     char   *dn, 
     int     flags);

Parameters

ld: (IN) Points to the handle for the LDAP session.
dn: (IN) Specifies the distinguished name, in LDAP format, of the child partition's root that is to be joined to its parent.
flags: (IN) Specifies whether all the servers in the replica ring must be up before proceeding. When set to zero, the status of the servers is not checked. When set to LDAP_ENSURE_SERVERS_UP, all the servers must be up for the operation to proceed.

Return Values

0x00	LDAP_SUCCESS
0x01	LDAP_OPERATIONS_ERROR: A string is returned with this error code that indicates the source of the error.
0x53	LDAP_ENCODING_ERROR
0x5A	LDAP_NO_MEMORY
0x5C	LDAP_NOT_SUPPORTED
Non-zero	Non-zero values indicate errors. See LDAP Return Codes.

Remarks

This operation is performed on the server containing the master replica of the parent partition. The caller must have supervisor rights to the child's master replica and the parent's master replica.

For sample code, see joinpart.c.

Packet Format

The requestName is set to the OID (2.16.840.1.113719.1.27.100.5) and the requestValue is a BER encoding of the following:

  RequestBer
      flags       INTEGER
      dn          LDAPDN

The responseName is set to the OID (2.16.840.1.113719.1.27.100.6) and the requestValue has no value.