DN normalization extended operation

Edit online

The DN normalization extended operation explains its use with the server and provides the results.

Description
The DN normalization extended operation normalizes a DN or a list of DNs. The normalization is based on the server schema.
Note: This extended operation is always enabled.
Request
OID
1.3.18.0.2.12.30
Syntax
RequestValue ::= SEQUENCE {
	    case			INTEGER {preserve(0), normalize (1)};
	    SEQUENCE of DistinguishedName;
	}
Response
OID
1.3.18.0.2.12.30
Syntax
ResultValue ::= SEQUENCE {
		SEQUENCE of SEQUENCE {
		Return code		INTEGER;
		DN			Normalized DistinguishedName;
	}
	}
Each DN has its own return code. If the return code is not SUCCESS, a DN of zero length is returned for every DN passed in the original request. The order of DN values in the response matches the order of DN values that are passed in the request. The LDAP return code and their corresponding error condition for the extended operation is as follows:
  • Success: The DN was normalized successfully.
  • UndefinedAttributeType: An attribute in the DN is undefined.
  • InvalidDNSyntax: The DN syntax is invalid.
Behavior
The extended operation normalizes a DN, or list of DNs. The normalization is based on the schema. See slapi_dn_normalize_v3 in the IBM® Verify Directory Server Plug-ins Reference.

All users can run this extended operation.

This extended operation has the following possible return codes:
  • LDAP_SUCCESS
  • LDAP_PROTOCOL_ERROR
  • LDAP_OTHER
  • LDAP_OPERATIONS_ERROR
This extended operation is supported by the Administration Server.
Scope
The extended operation affects only the current operation.