Diff for /doc/man/man8/slapcat.8 between versions 1.36 and 1.44

version 1.36, 2007/11/14 09:00:36 version 1.44, 2010/04/13 20:17:47
Line 1 Line 1
 .TH SLAPCAT 8C "RELEASEDATE" "OpenLDAP LDVERSION"  .TH SLAPCAT 8C "RELEASEDATE" "OpenLDAP LDVERSION"
 .\" $OpenLDAP: pkg/ldap/doc/man/man8/slapcat.8,v 1.35 2007/07/22 16:30:46 hyc Exp $  .\" Copyright 1998-2010 The OpenLDAP Foundation All Rights Reserved.
 .\" Copyright 1998-2007 The OpenLDAP Foundation All Rights Reserved.  
 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.  .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   .\" $OpenLDAP: pkg/ldap/doc/man/man8/slapcat.8,v 1.43 2010/01/18 14:00:42 ando Exp $
 .SH NAME  .SH NAME
 slapcat \- SLAPD database to LDIF utility  slapcat \- SLAPD database to LDIF utility
 .SH SYNOPSIS  .SH SYNOPSIS
 .B SBINDIR/slapcat  .B SBINDIR/slapcat
 .B [\-a filter]  [\c
 .B [\-b suffix]  .BI \-a filter\fR]
 .B [\-c]  [\c
 .B [\-d level]  .BI \-b suffix\fR]
 .B [\-f slapd.conf]  [\c
 .B [\-F confdir]  .BR \-c ]
 .B [\-g]  [\c
 .B [\-l ldif-file]  .BI \-d debug-level\fR]
 .B [\-n dbnum]  [\c
 .B [\-o name[=value]]  .BI \-f slapd.conf\fR]
 .B [\-s subtree-dn]  [\c
 .B [\-v]  .BI \-F confdir\fR]
 .B   [\c
   .BR \-g ]
   [\c
   .BI \-H URI\fR]
   [\c
   .BI \-l ldif-file\fR]
   [\c
   .BI \-n dbnum\fR]
   [\c
   .BI \-o option\fR[ = value\fR]]
   [\c
   .BI \-s subtree-dn\fR]
   [\c
   .BR \-v ]
 .LP  .LP
 .SH DESCRIPTION  .SH DESCRIPTION
 .LP  .LP
Line 32  suffix and writes the corresponding LDIF Line 45  suffix and writes the corresponding LDIF
 the specified file.  the specified file.
 Databases configured as  Databases configured as
 .B subordinate  .B subordinate
 of this one are also output, unless \fB-g\fP is specified.  of this one are also output, unless \fB\-g\fP is specified.
 .LP  .LP
 The entry records are presented in database order, not superior first  The entry records are presented in database order, not superior first
 order.  The entry records will include all (user and operational)  order.  The entry records will include all (user and operational)
Line 49  into superior first order and removing n Line 62  into superior first order and removing n
 operational attributes.  operational attributes.
 .SH OPTIONS  .SH OPTIONS
 .TP  .TP
 .BI \-a " filter"  .BI \-a \ filter
 Only dump entries matching the asserted filter.  Only dump entries matching the asserted filter.
 For example  For example
   
 slapcat -a \\  slapcat \-a \\
     "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"      "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"
   
 will dump all but the "ou=People,dc=example,dc=com" subtree  will dump all but the "ou=People,dc=example,dc=com" subtree
 of the "dc=example,dc=com" database.  of the "dc=example,dc=com" database.
   Deprecated; use \fB-H\fP \fIldap:///???(filter)\fP instead.
 .TP  .TP
 .BI \-b " suffix"   .BI \-b \ suffix 
 Use the specified \fIsuffix\fR to determine which database to  Use the specified \fIsuffix\fR to determine which database to
 generate output for.  The \-b cannot be used in conjunction  generate output for.  The \fB\-b\fP cannot be used in conjunction
 with the  with the
 .B \-n  .B \-n
 option.  option.
Line 69  option. Line 83  option.
 .B \-c  .B \-c
 Enable continue (ignore errors) mode.  Enable continue (ignore errors) mode.
 .TP  .TP
 .BI \-d " level"  .BI \-d \ debug-level
 Enable debugging messages as defined by the specified  Enable debugging messages as defined by the specified
 .IR level ;  .IR debug-level ;
 see  see
 .BR slapd (8)  .BR slapd (8)
 for details.  for details.
 .TP  .TP
 .BI \-f " slapd.conf"  .BI \-f \ slapd.conf
 Specify an alternative  Specify an alternative
 .BR slapd.conf (5)  .BR slapd.conf (5)
 file.  file.
 .TP  .TP
 .BI \-F " confdir"  .BI \-F \ confdir
 specify a config directory.  specify a config directory.
 If both  If both
 .B -f  .B \-f
 and  and
 .B -F  .B \-F
 are specified, the config file will be read and converted to  are specified, the config file will be read and converted to
 config directory format and written to the specified directory.  config directory format and written to the specified directory.
 If neither option is specified, an attempt to read the  If neither option is specified, an attempt to read the
Line 98  default config file is ignored. Line 112  default config file is ignored.
 disable subordinate gluing.  Only the specified database will be  disable subordinate gluing.  Only the specified database will be
 processed, and not its glued subordinates (if any).  processed, and not its glued subordinates (if any).
 .TP  .TP
 .BI \-l " ldif-file"  .B \-H \ URI
   use dn, scope and filter from URI to only handle matching entries.
   .TP
   .BI \-l \ ldif-file
 Write LDIF to specified file instead of standard output.  Write LDIF to specified file instead of standard output.
 .TP  .TP
 .BI \-n " dbnum"  .BI \-n \ dbnum
 Generate output for the \fIdbnum\fR\-th database listed in the  Generate output for the \fIdbnum\fR-th database listed in the
 configuration file.  The  configuration file. The config database
   .BR slapd\-config (5),
   is always the first database, so use
   .B \-n 0
   to select it.
   
   The
 .B \-n  .B \-n
 cannot be used in conjunction with the  cannot be used in conjunction with the
 .B \-b  .B \-b
 option.  option.
 .TP  .TP
 .BI \-o " option[=value]"  .BI \-o \ option\fR[ = value\fR]
 Specify an  Specify an
 .BR option  .I option
 with a(n optional)  with a(n optional)
 .BR value .  .IR value .
 Possible generic options/values are:  Possible generic options/values are:
 .LP  .LP
 .nf  .nf
               syslog=<subsystems>  (see `\-s' in slapd(8))                syslog=<subsystems>  (see `\-s' in slapd(8))
               syslog-level=<level> (see `\-S' in slapd(8))                syslog\-level=<level> (see `\-S' in slapd(8))
               syslog-user=<user>   (see `\-l' in slapd(8))                syslog\-user=<user>   (see `\-l' in slapd(8))
   
 .fi  .fi
 .TP  .TP
 .BI \-s " subtree-dn"  .BI \-s \ subtree-dn
 Only dump entries in the subtree specified by this DN.  Only dump entries in the subtree specified by this DN.
 Implies `-b subtree-dn' if no  Implies \fB\-b\fP \fIsubtree-dn\fP if no
 .B \-b  .B \-b
 or  or
 .B \-n  .B \-n
 option is given.  option is given.
   Deprecated; use \fB-H\fP \fIldap:///subtree-dn\fP instead.
 .TP  .TP
 .B \-v  .B \-v
 Enable verbose mode.  Enable verbose mode.
Line 141  mode) when you do this to ensure consist Line 165  mode) when you do this to ensure consist
 always safe to run   always safe to run 
 .B slapcat  .B slapcat
 with the  with the
 .BR slapd-bdb (5),  .BR slapd\-bdb (5),
 .BR slapd-hdb (5),  .BR slapd\-hdb (5),
 and  and
 .BR slapd-null (5)  .BR slapd\-null (5)
 backends.  backends.
 .SH EXAMPLES  .SH EXAMPLES
 To make a text backup of your SLAPD database and put it in a file called  To make a text backup of your SLAPD database and put it in a file called
Line 153  give the command: Line 177  give the command:
 .LP  .LP
 .nf  .nf
 .ft tt  .ft tt
         SBINDIR/slapcat -l ldif          SBINDIR/slapcat \-l ldif
 .ft  .ft
 .fi  .fi
 .SH "SEE ALSO"  .SH "SEE ALSO"

Removed from v.1.36  
changed lines
  Added in v.1.44


______________
© Copyright 1998-2020, OpenLDAP Foundation, info@OpenLDAP.org