git.sur5r.net Git - openldap/blob - doc/man/man8/slapindex.8

   1 .TH SLAPINDEX 8C "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-2006 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 slapindex \- SLAPD index to LDIF utility
   7 .SH SYNOPSIS
   8 .B SBINDIR/slapindex
   9 .B [\-b suffix]
  10 .B [\-c]
  11 .B [\-d level]
  12 .B [\-f slapd.conf]
  13 .B [\-F confdir]
  14 .B [\-g]
  15 .B [\-n dbnum]
  16 .B [\-o name[=value]
  17 .B [\-q]
  18 .B [\-v]
  19 .B
  20 .LP
  21 .SH DESCRIPTION
  22 .LP
  23 .B Slapindex
  24 is used to regenerate
  25 .BR slapd (8)
  26 indices based upon the current contents of a database.
  27 It opens the given database determined by the database number or
  28 suffix and updates the indices for all values of all attributes
  29 of all entries.
  30 Databases configured as
  31 .B subordinate
  32 of this one are also re-indexed, unless \fB-g\fP is specified.
  33 .SH OPTIONS
  34 .TP
  35 .BI \-b " suffix"
  36 Use the specified \fIsuffix\fR to determine which database to
  37 generate output for.  The \-b cannot be used in conjunction
  38 with the
  39 .B \-n
  40 option.
  41 .TP
  42 .B \-c
  43 enable continue (ignore errors) mode.
  44 .TP
  45 .BI \-d " level"
  46 enable debugging messages as defined by the specified
  47 .IR level .
  48 .TP
  49 .BI \-f " slapd.conf"
  50 specify an alternative
  51 .BR slapd.conf (5)
  52 file.
  53 .TP
  54 .BI \-F " confdir"
  55 specify a config directory.
  56 If both
  57 .B -f
  58 and
  59 .B -F
  60 are specified, the config file will be read and converted to
  61 config directory format and written to the specified directory.
  62 If neither option is specified, an attempt to read the
  63 default config directory will be made before trying to use the default
  64 config file. If a valid config directory exists then the
  65 default config file is ignored.
  66 .TP
  67 .B \-g
  68 disable subordinate gluing.  Only the specified database will be
  69 processed, and not its glued subordinates (if any).
  70 .TP
  71 .BI \-n " dbnum"
  72 Generate output for the \fIdbnum\fR\-th database listed in the
  73 configuration file.  The
  74 .B \-n
  75 cannot be used in conjunction with the
  76 .B \-b
  77 option.
  78 .TP
  79 .BI \-o " option[=value]"
  80 Specify an
  81 .BR option
  82 with a(n optional)
  83 .BR value .
  84 Possible generic options/values are:
  85 .LP
  86 .nf
  87               syslog=<subsystems>  (see `\-s' in slapd(8))
  88               syslog-level=<level> (see `\-S' in slapd(8))
  89               syslog-user=<user>   (see `\-l' in slapd(8))
  90
  91 .fi
  92 .TP
  93 .B \-q
  94 enable quick (fewer integrity checks) mode. Performs no consistency checks
  95 when writing the database. Improves indexing time,
  96 .B however
  97 the database will most likely be unusable if any errors or
  98 interruptions occur.
  99 .TP
 100 .B \-v
 101 enable verbose mode.
 102 .SH LIMITATIONS
 103 Your
 104 .BR slapd (8)
 105 should not be running (at least, not in read-write
 106 mode) when you do this to ensure consistency of the database.
 107 .LP
 108 This command provides ample opportunity for the user to obtain
 109 and drink their favorite beverage.
 110 .SH EXAMPLES
 111 To reindex your SLAPD database, give the command:
 112 .LP
 113 .nf
 114 .ft tt
 115         SBINDIR/slapindex
 116 .ft
 117 .fi
 118 .SH "SEE ALSO"
 119 .BR ldap (3),
 120 .BR ldif (5),
 121 .BR slapadd (8),
 122 .BR ldapadd (1),
 123 .BR slapd (8)
 124 .LP
 125 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
 126 .SH ACKNOWLEDGEMENTS
 127 .so ../Project