NAME

       slapo-valsort - Value Sorting overlay to slapd

SYNOPSIS

       /etc/ldap/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/ldap/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.

OpenLDAP                                           2012/04/23                                   SLAPO-VALSORT(5)