Subject: SSS Request Control
Author: SteveHB
In response to: LDAP Server Side Sorting (SSS) Control -- RFC 2891
Posted on: 01/06/2009 08:04:29 PM
This control is included in the searchRequest message as part of the controls field of the LDAPMessage, as defined in Section 4.1.12 of [LDAPv3].
The controlType is set to "1.2.840.113556.1.4.473". The criticality MAY be either TRUE or FALSE (where absent is also equivalent to FALSE) at the client's option. The controlValue is an OCTET STRING, whose value is the BER encoding of a value of the following SEQUENCE:
SortKeyList ::= SEQUENCE OF SEQUENCE {
attributeType AttributeDescription,
orderingRule [0] MatchingRuleId OPTIONAL,
reverseOrder [1] BOOLEAN DEFAULT FALSE
}
The
SortKeyList sequence is in order of highest to lowest sort key precedence.
The
MatchingRuleId, as defined in section 4.1.9 of [LDAPv3], SHOULD be one that is valid for the attribute type it applies to. If it is not, the server will return
inappropriateMatching.
Each
attributeType should only occur in the SortKeyList once. If an attributeType is included in the sort key list multiple times, the server should return an error in the sortResult of
unwillingToPerform.
If the
orderingRule is omitted, the ordering MatchingRule defined for use with this attribute MUST be used.
Any conformant implementation of this control MUST allow a sort key list with at least one key.
>
> On 01/06/2009 07:52:46 PM
SteveHB wrote:
http://tools.ietf.org/html/rfc2891
This document describes two LDAPv3 control extensions for server side sorting of search results. These controls allows a client to specify the attribute types and matching rules a server should use when returning the results to an LDAP search request. The controls may be useful when the LDAP client has limited functionality or for some other reason cannot sort the results but still needs them sorted.
The sort controls allow a server to return a result code for the sorting of the results that is independent of the result code returned for the search operation.
References:
