1 .TH SLAPO-VALSORT 5 "2008/07/16" "OpenLDAP 2.4.11"
2 .\" Copyright 2005-2008 The OpenLDAP Foundation All Rights Reserved.
3 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
4 .\" $OpenLDAP: pkg/ldap/doc/man/man5/slapo-valsort.5,v 1.4.2.3 2008/02/11 23:26:40 kurt Exp $
6 slapo-valsort \- Value Sorting overlay to slapd
8 /etc/openldap/slapd.conf
10 The Value Sorting overlay can be used with a backend database to sort the
11 values of specific multi-valued attributes within a subtree. The sorting
12 occurs whenever the attributes are returned in a search response.
14 Sorting can be specified in ascending or descending order, using either
15 numeric or alphanumeric sort methods. Additionally, a "weighted" sort can
16 be specified, which uses a numeric weight prepended to the attribute values.
17 The weighted sort is always performed in ascending order, but may be combined
18 with the other methods for values that all have equal weights. The weight
19 is specified by prepending an integer weight {<\fIweight\fP>}
20 in front of each value of the attribute for which weighted sorting is
21 desired. This weighting factor is stripped off and never returned in
27 options apply to the Value Sorting overlay.
28 They should appear after the
32 valsort-attr <\fIattribute\fP> <\fIbaseDN\fP> (<\fIsort-method\fP> | weighted [<\fIsort-method\fP>])
33 Configure a sorting method for the specified
35 in the subtree rooted at
47 method is specified, a secondary
49 may also be specified. It is an
50 error to specify an alphanumeric
52 for an attribute with Integer
53 or NumericString syntax, and it is an error to specify a numeric
55 for an attribute with a syntax other than Integer or NumericString.
60 suffix dc=example,dc=com
63 valsort-attr member ou=groups,dc=example,dc=com alpha-ascend
68 \fI/etc/openldap/slapd.conf\fP
69 default \fBslapd\fP configuration file
74 This module was written in 2005 by Howard Chu of Symas Corporation. The
75 work was sponsored by Stanford University.