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

version 1.28.2.17, 2011/01/04 23:49:51 version 1.36, 2007/11/14 09:00:36
Line 1 Line 1
 .TH SLAPCAT 8C "RELEASEDATE" "OpenLDAP LDVERSION"  .TH SLAPCAT 8C "RELEASEDATE" "OpenLDAP LDVERSION"
 .\" Copyright 1998-2011 The OpenLDAP Foundation All Rights Reserved.  .\" $OpenLDAP: pkg/ldap/doc/man/man8/slapcat.8,v 1.35 2007/07/22 16:30:46 hyc Exp $
   .\" 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.28.2.16 2011/01/04 18:57:26 quanah 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
 [\c  .B [\-a filter]
 .BI \-a filter\fR]  .B [\-b suffix]
 [\c  .B [\-c]
 .BI \-b suffix\fR]  .B [\-d level]
 [\c  .B [\-f slapd.conf]
 .BR \-c ]  .B [\-F confdir]
 [\c  .B [\-g]
 .BI \-d debug-level\fR]  .B [\-l ldif-file]
 [\c  .B [\-n dbnum]
 .BI \-f slapd.conf\fR]  .B [\-o name[=value]]
 [\c  .B [\-s subtree-dn]
 .BI \-F confdir\fR]  .B [\-v]
 [\c  .B 
 .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 45  suffix and writes the corresponding LDIF Line 32  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 62  into superior first order and removing n Line 49  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 \fB\-b\fP cannot be used in conjunction  generate output for.  The \-b cannot be used in conjunction
 with the  with the
 .B \-n  .B \-n
 option.  option.
 .TP  .TP
 .B \-c  .B \-c
 Enable continue (ignore errors) mode.  Enable continue (ignore errors) mode.
 Multiple occorrences of  
 .B \-c  
 make  
 .BR slapcat (8)  
 try harder.  
 .TP  .TP
 .BI \-d \ debug-level  .BI \-d " level"
 Enable debugging messages as defined by the specified  Enable debugging messages as defined by the specified
 .IR debug-level ;  .IR 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 117  default config file is ignored. Line 98  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
 .B \-H \ URI  .BI \-l " ldif-file"
 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 config database  configuration file.  The
 .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\fR[ = value\fR]  .BI \-o " option[=value]"
 Specify an  Specify an
 .I option  .BR option
 with a(n optional)  with a(n optional)
 .IR value .  .BR 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))
   
               ldif-wrap={no|<n>}  .fi
   
 .in  
 \fIn\fP is the number of columns allowed for the LDIF output  
 (\fIn\fP equal to \fI0\fP uses the default, corresponding to 76).  
 Use \fIno\fP for no wrap.  
 .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 \fB\-b\fP \fIsubtree-dn\fP if no  Implies `-b subtree-dn' 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 175  mode) when you do this to ensure consist Line 141  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 187  give the command: Line 153  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.28.2.17  
changed lines
  Added in v.1.36


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