ldap_receive_all_updates

Requests that a specified replica on a specified server receive all updates.

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_receive_all_updates (
     LDAP   *ld, 
     char   *partitionRoot, 
     char   *toServerDN, 
     char   *fromServerDN);

Parameters

ld: (IN) Points to the handle for the LDAP session.
partitionRoot: (IN) Points to the distinguished name, in LDAP format, of the replica that receives the updates.
toServerDN: (IN) Points to the distinguished name, in LDAP format, of the server holding the replica to be updated.
fromServerDN: (IN) Points to distinguished name, in LDAP format, of the server from which the updates are sent. Not currently used.

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

A replica's distinguished name is the distinguished name of the replica's root container, called the partition root in eDirectory.

In NDS 7.x and above, updates can come from any server that holds a replica of the partition; therefore, eDirectory does not currently use the fromServerDN parameter to specify which server should send the updates.

Each ld is associated with a particular server. eDirectory uses the ld rather than the toServerDN parameter to specify the server with the replica that needs updating.

For sample code, see recvupd.c.

Packet Format

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

  RequestBer
     partitionRoot   LDAPDN
     toServerDN      LDAPDN
     fromServerDN    LDAPDN

The responseName is set to the OID (2.16.840.1.113719.1.27.100.22) and the responseValue has no value.