1.10 Controls and Extensions

Controls and Extensions were added to version 3 of the LDAP protocol. In version 2, there was no standard mechanism to extend the protocol, requiring developers to extend the protocol non-standard ways. In version 3, extensions and controls were defined to provide consistent expansion of the protocol.

NOTE:The eDirectory and LDAP Integration guide contains a good introduction to LDAP controls and extensions, and contains information and limitations you need to be aware of when using these controls with eDirectory. It is recommended that you read the LDAP Controls and the LDAP Extensions chapters in the eDirectory and LDAP Integration guide.

1.10.1 Controls

The following table contains a list of controls supported in the LDAP Libraries for C. For examples using these controls, see the LDAP Libraries for C Sample Code.

Table 1-10 Supported Controls in the LDAP Libraries for C

OID

Description

1.2.840.113556.1.4.473

Sever-side sort control request

1.2.840.113556.1.4.474

Server-side sort control response

2.16.840.1.113730.3.4.9

Virtual list view request

2.16.840.1.113730.3.4.10

Virtual list view response

2.16.840.1.113730.3.4.3

Persistent search

2.16.840.1.113730.3.4.7

Entry change notification

  • Server Side Sort. Returns results from a search operation in sorted order. This can be used to off-load processing from the client, or if you cannot sort the results on the client.

  • Vertical List View. Works in conjunction with the Server Side Sort control to provide a dynamic view of a scrolling list.

  • Persistent Search & Entry Change Notification. Performs a continuous search notifying the application of changes as they occur.

1.10.2 Extensions

The following table contains a list of extensions supported in the LDAP Libraries for C. For examples using these extensions, see the LDAP Libraries for C Sample Code.

Table 1-11 Supported Extensions in the LDAP Libraries for C

OID

Name

2.16.840.1.113719.1.27.100.1

ndsToLdapResponse

2.16.840.1.113719.1.27.100.2

ndsToLdapRequest

2.16.840.1.113719.1.27.100.3

splitPartitionRequest

2.16.840.1.113719.1.27.100.4

splitPartitionResponse

2.16.840.1.113719.1.27.100.5

mergePartitionRequest

2.16.840.1.113719.1.27.100.6

mergePartitionResponse

2.16.840.1.113719.1.27.100.7

addReplicaRequest

2.16.840.1.113719.1.27.100.8

addReplicaResponse

2.16.840.1.113719.1.27.100.9

refreshLDAPServerRequest

2.16.840.1.113719.1.27.100.10

refreshLDAPServerResponse

2.16.840.1.113719.1.27.100.11

removeReplicaRequest

2.16.840.1.113719.1.27.100.12

removeReplicaResponse

2.16.840.1.113719.1.27.100.13

partitionEntryCountRequest

2.16.840.1.113719.1.27.100.14

partitionEntryCountResponse

2.16.840.1.113719.1.27.100.15

changeReplicaTypeRequest

2.16.840.1.113719.1.27.100.16

changeReplicaTypeResponse

2.16.840.1.113719.1.27.100.17

getReplicaInfoRequest

2.16.840.1.113719.1.27.100.18

getReplicaInfoResponse

2.16.840.1.113719.1.27.100.19

listReplicaRequest

2.16.840.1.113719.1.27.100.20

listReplicaResponse

2.16.840.1.113719.1.27.100.21

receiveAllUpdatesRequest

2.16.840.1.113719.1.27.100.22

receiveAllUpdatesResponse

2.16.840.1.113719.1.27.100.23

sendAllUpdatesRequest

2.16.840.1.113719.1.27.100.24

sendAllUpdatesResponse

2.16.840.1.113719.1.27.100.25

requestPartitionSyncRequest

2.16.840.1.113719.1.27.100.26

requestPartitionSyncResponse

2.16.840.1.113719.1.27.100.27

requestSchemaSyncRequest

2.16.840.1.113719.1.27.100.28

requestSchemaSyncResponse

2.16.840.1.113719.1.27.100.29

abortPartitionOperationRequest

2.16.840.1.113719.1.27.100.30

abortPartitionOperationResponse

2.16.840.1.113719.1.27.100.31

getBindDNRequest

2.16.840.1.113719.1.27.100.32

getBindDNResponse

2.16.840.1.113719.1.27.100.33

getEffectivePrivilegesRequest

2.16.840.1.113719.1.27.100.34

getEffectivePrivilegesResponse

2.16.840.1.113719.1.27.100.35

setReplicationFilterRequest

2.16.840.1.113719.1.27.100.36

setReplicationFilterResponse

2.16.840.1.113719.1.27.100.37

getReplicationFilterRequest

2.16.840.1.113719.1.27.100.38

getReplicationFilterResponse

2.16.840.1.113719.1.27.100.39

splitOrphanPartitionRequest

2.16.840.1.113719.1.27.100.40

splitOrphanPartitionResponse

2.16.840.1.113719.1.27.100.41

removeOrphanPartitionRequest

2.16.840.1.113719.1.27.100.42

removeOrphanPartitionResponse