# slapindex

## NAME



           slapindex - Reindex entries in a SLAPD database
    


## SYNOPSIS



           **SBINDIR/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.
    
           This command provides ample opportunity for the user to obtain and
           drink their favorite beverage.
    


## EXAMPLES



           To reindex your SLAPD database, give the command:
    
                SBINDIR/slapindex
           To regenerate the index for only a specific attribute, e.g. "uid",
           give the command:
    
                SBINDIR/slapindex uid
    


## 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.
    


* * *