xref: /netbsd-src/external/bsd/openldap/man/slapo-valsort.5 (revision a5847cc334d9a7029f6352b847e9e8d71a0f9e0c)
SLAPO-VALSORT 5 "2010/06/30" "OpenLDAP 2.4.23"
Copyright 2005-2010 The OpenLDAP Foundation All Rights Reserved.
Copying restrictions apply. See COPYRIGHT/LICENSE.
OpenLDAP: pkg/ldap/doc/man/man5/slapo-valsort.5,v 1.4.2.7 2010/04/13 20:22:45 kurt Exp
NAME
slapo-valsort - Value Sorting overlay to slapd
SYNOPSIS
/etc/openldap/slapd.conf
DESCRIPTION
The Value Sorting overlay can be used with a backend database to sort the values of specific multi-valued attributes within a subtree. The sorting occurs whenever the attributes are returned in a search response.

Sorting can be specified in ascending or descending order, using either numeric or alphanumeric sort methods. Additionally, a "weighted" sort can be specified, which uses a numeric weight prepended to the attribute values. The weighted sort is always performed in ascending order, but may be combined with the other methods for values that all have equal weights. The weight is specified by prepending an integer weight {<weight>} in front of each value of the attribute for which weighted sorting is desired. This weighting factor is stripped off and never returned in search results.

CONFIGURATION
These slapd.conf options apply to the Value Sorting overlay. They should appear after the overlay directive.

valsort-attr <attribute> <baseDN> (<sort-method> | weighted [<sort-method>]) Configure a sorting method for the specified attribute in the subtree rooted at baseDN . The sort-method may be one of alpha-ascend , alpha-descend , numeric-ascend , or numeric-descend . If the special weighted method is specified, a secondary sort-method may also be specified. It is an error to specify an alphanumeric sort-method for an attribute with Integer or NumericString syntax, and it is an error to specify a numeric sort-method for an attribute with a syntax other than Integer or NumericString.

EXAMPLES

 database bdb
 suffix dc=example,dc=com
 ...
 overlay valsort
 valsort-attr member ou=groups,dc=example,dc=com alpha-ascend
FILES

/etc/openldap/slapd.conf default slapd configuration file

SEE ALSO
slapd.conf (5), slapd-config (5).
ACKNOWLEDGEMENTS

This module was written in 2005 by Howard Chu of Symas Corporation. The work was sponsored by Stanford University.