Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   17783 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SLAPO-VALSORT(5)					      SLAPO-VALSORT(5)

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
       not returned in search results unless the valsort control is  specified
       (1.3.6.1.4.1.4203.666.5.14).

       The valsort control requires a value consisting of a Sequence that con‐
       tains a boolean flag. The weighting factor  is  only  returned  if  the
       boolean	value  is  TRUE.  In lber-encode(3) format, the required value
       must conform to "{b}" syntax.

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 Numer‐
	      icString 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

       To invoke ldapsearch(1) with the valsort	 control,  the	control	 value
       must  be set appropriately.  The following octets represent the desired
       "{b}" encoding:

	    0x30 0x03 0x01 0x01 0xff

       The control can be sent from the command-line using the base64 encoding
       of the value:

	    ldapsearch -E 1.3.6.1.4.1.4203.666.5.14=::MAMBAf8=

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.

OpenLDAP 2.4.38			  2013/11/16		      SLAPO-VALSORT(5)

Vote for polarhome