.TH SLAPCAT 8C "RELEASEDATE" "OpenLDAP LDVERSION"
.\" $OpenLDAP$
-.\" Copyright 1998-2003 The OpenLDAP Foundation All Rights Reserved.
+.\" Copyright 1998-2006 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
.SH NAME
slapcat \- SLAPD database to LDIF utility
.B SBINDIR/slapcat
.B [\-v]
.B [\-c]
-.B [\-k]
-.B [\-m]
+.B [\-g]
.B [\-d level]
.B [\-b suffix]
.B [\-n dbnum]
+.B [\-a filter]
.B [\-s subtree-dn]
.B [\-f slapd.conf]
+.B [\-F confdir]
.B [\-l ldif-file]
.B
.LP
It opens the given database determined by the database number or
suffix and writes the corresponding LDIF to standard output or
the specified file.
+Databases configured as
+.B subordinate
+of this one are also output, unless \fB-g\fP is specified.
.LP
The LDIF generated by this tool is suitable for use with
.BR slapadd (8).
.B \-c
Enable continue (ignore errors) mode.
.TP
-.B \-k
-Include
-.B syncConsumerSubentry
-of the syncrepl consumer in the generated LDIF output.
-.TP
-.B \-m
-Include
-.B syncProviderSubentry
-of the syncrepl provider in the generated LDIF output.
+.B \-g
+disable subordinate gluing. Only the specified database will be
+processed, and not its glued subordinates (if any).
.TP
.BI \-d " level"
Enable debugging messages as defined by the specified
.B \-b
option.
.TP
+.BI \-a " filter"
+Only dump entries matching the asserted filter.
+For example
+
+slapcat -a \\
+ "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"
+
+will dump all but the "ou=People,dc=example,dc=com" subtree
+of the "dc=example,dc=com" database.
+.TP
.BI \-s " subtree-dn"
Only dump entries in the subtree specified by this DN.
Implies `-b subtree-dn' if no
.BR slapd.conf (5)
file.
.TP
+.BI \-F " confdir"
+specify a config directory.
+If both
+.B -f
+and
+.B -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.
+.TP
.BI \-l " ldif-file"
Write LDIF to specified file instead of standard output.
-.SH Limitations
-Your
+.SH LIMITATIONS
+In general, your
.BR slapd (8)
should not be running (at least, not in read-write
mode) when you do this to ensure consistency of the database.