git.sur5r.net Git - openldap/blob - doc/man/man5/slapo-sssvlv.5

   1 .TH SLAPO-SSSVLV 5 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" Copyright 2009-2014 The OpenLDAP Foundation All Rights Reserved.
   3 .\" Copyright 2009 Symas Corporation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .\" $OpenLDAP$
   6 .SH NAME
   7 slapo\-sssvlv \- Server Side Sorting and Virtual List View overlay to slapd
   8 .SH SYNOPSIS
   9 ETCDIR/slapd.conf
  10 .SH DESCRIPTION
  11 This overlay implements the LDAP Server Side Sorting (RFC2891) control
  12 as well as the Virtual List View control. It also replaces the default
  13 implementation of the LDAP PagedResults (RFC2696) control, to ensure
  14 that it works with Sorting. The overlay can be used with any backend
  15 or globally for all backends.
  16
  17 Since a complete result set must be generated in memory before sorting can
  18 be performed, processing sort requests can have a large impact on the
  19 server's memory use. As such, any connection is limited to having only
  20 a limited number of sort requests active at a time. Additional limits may
  21 be configured as described below.
  22
  23 .SH CONFIGURATION
  24 These
  25 .B slapd.conf
  26 options apply to the SSSVLV overlay.
  27 They should appear after the
  28 .B overlay
  29 directive.
  30 .TP
  31 .B sssvlv\-max <num>
  32 Set the maximum number of concurrent sort requests allowed across all
  33 connections. The default is one half of the number of server threads.
  34 .TP
  35 .B sssvlv\-maxkeys <num>
  36 Set the maximum number of keys allowed in a sort request. The default is 5.
  37 .TP
  38 .B sssvlv\-maxperconn <num>
  39 Set the maximum number of concurrent paged search requests per connection. The default is 5. The number of concurrent requests remains limited by
  40 .B sssvlv-max.
  41 .SH FILES
  42 .TP
  43 ETCDIR/slapd.conf
  44 default slapd configuration file
  45 .TP
  46 ETCDIR/slapd.d
  47 default slapd configuration directory
  48 .SH SEE ALSO
  49 .BR slapd.conf (5),
  50 .BR slapd\-config (5).
  51 .LP
  52 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
  53 .LP
  54 IETF LDAP Virtual List View proposal by D. Boreham, J. Sermersheim,
  55 and A. Kashi in IETF document "draft-ietf-ldapext-ldapv3-vlv-09.txt".
  56 .SH AUTHOR
  57 Howard Chu