NAME

       slapindex - Reindex entries in a SLAPD database

SYNOPSIS

       /usr/sbin/slapindex  [-b suffix]  [-c]  [-d debug-level] [-f slapd.conf] [-F confdir] [-g]
       [-n dbnum] [-o option[=value]] [-q] [-t] [-v] [attr[...]]

DESCRIPTION

       Slapindex is used to regenerate slapd(8) indices based upon  the  current  contents  of  a
       database.   It  opens  the  given database determined by the database number or suffix and
       updates the indices for all values of all attributes of all entries. If a list of specific
       attributes  is provided on the command line, only the indices for those attributes will be
       regenerated.  Databases configured as subordinate of this one are also re-indexed,  unless
       -g is specified.

       All files eventually created by slapindex will belong to the identity slapindex is run as,
       so make sure you either run slapindex with the same identity slapd(8) will be run as  (see
       option -u in slapd(8)), or change file ownership before running slapd(8).

OPTIONS

       -b suffix
              Use  the  specified  suffix  to determine which database to generate output for. By
              default, the first database that supports the requested operation is used.  The  -b
              cannot be used in conjunction with the -n option.

       -c     enable continue (ignore errors) mode.

       -d debug-level
              enable debugging messages as defined by the specified debug-level; see slapd(8) for
              details.

       -f slapd.conf
              specify an alternative slapd.conf(5) file.

       -F confdir
              specify a config directory.  If both -f and -F are specified, the config file  will
              be  read  and  converted  to  config  directory format and written to the specified
              directory.  If neither option is specified, an attempt to read the  default  config
              directory  will  be  made  before trying to use the default config file. If a valid
              config directory exists then the default config file is ignored.

       -g     disable subordinate gluing.  Only the specified database will be processed, and not
              its glued subordinates (if any).

       -n dbnum
              Generate  output  for  the  dbnum-th database listed in the configuration file. The
              config database slapd-config(5), is always the first database, so use -n 0

              The -n cannot be used in conjunction with the -b option.

       -o option[=value]
              Specify an option with a(n optional) value.  Possible generic options/values are:

                     syslog=<subsystems>  (see `-s' in slapd(8))
                     syslog-level=<level> (see `-S' in slapd(8))
                     syslog-user=<user>   (see `-l' in slapd(8))

       -q     enable quick (fewer integrity checks) mode. Performs  no  consistency  checks  when
              writing the database. Improves indexing time, however the database will most likely
              be unusable if any errors or interruptions occur.

       -t     enable truncate mode. Truncates (empties) an index  database  before  indexing  any
              entries. May only be used with back-mdb.

       -v     enable verbose mode.

LIMITATIONS

       Your slapd(8) should not be running (at least, not in read-write mode) when you do this to
       ensure consistency of the database.

       slapindex ought to be run as the user specified for slapd(8) to  ensure  correct  database
       permissions.

       This  command  provides  ample opportunity for the user to obtain and drink their favorite
       beverage.

EXAMPLES

       To reindex your SLAPD database, give the command:

            /usr/sbin/slapindex
       To regenerate the index for only a specific attribute, e.g. "uid", give the command:

            /usr/sbin/slapindex uid

SEE ALSO

       ldap(3), ldif(5), slapadd(8), ldapadd(1), slapd(8)

       "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)

ACKNOWLEDGEMENTS

       OpenLDAP   Software   is   developed   and   maintained   by    The    OpenLDAP    Project
       <http://www.openldap.org/>.   OpenLDAP Software is derived from the University of Michigan
       LDAP 3.3 Release.