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

   1 .TH EDB2LDIF 8C "12 November 1995" "U-M LDAP LDVERSION"
   2 .SH NAME
   3 edb2ldif \- QUIPU EDB file to LDIF conversion tool
   4 .SH SYNOPSIS
   5 .B ETCDIR/edb2ldif
   6 .B [\-d] [\-v] [\-r] [\-o] [\-b basedn]
   7 .B [\-a addvalsfile] [\-f fileattrdir]
   8 .B [\-i ignoreattr...] [edbfile...]
   9 .B
  10 .SH DESCRIPTION
  11 .LP
  12 Data that is held in a QUIPU DSA (available as part of the ISODE package)
  13 is stored in or can be easily converted to the EDB file format.  The
  14 .I edb2ldif
  15 tool is used to convert directory data from EDB file format to the
  16 LDAP Directory Interchange Format (LDIF) used by
  17 .BR slapd (8)
  18 and associated utilities.  The
  19 .BR ldif2ldbm (8)
  20 program can be used to convert the resulting LDIF data into a database
  21 that is compatible with
  22 .BR slapd (8).
  23 .LP
  24 .I edb2ldif
  25 writes LDIF formatted data to standard output.  If you specify a particular
  26 .I edbfile
  27 (or files) to read data from, they are converted.  If no
  28 .I edbfile
  29 is specified, the files named
  30 .BR EDB.root
  31 (if it exists) and
  32 .BR EDB
  33 in the current directory are converted. An entire EDB hierarchy
  34 can be converted using the
  35 .B \-r
  36 option.
  37 .LP
  38 When
  39 .I edb2ldif
  40 is invoked, it will also look for files named
  41 .BR .add
  42 in the directories
  43 where EDB files are found and append the contents of the
  44 .BR .add
  45 file to each entry in the corresponding EDB file.
  46 Typically, this feature is used to include inherited
  47 attribute values (e.g., objectClass) that do not appear in the EDB files.
  48 .LP
  49 See "The SLAPD and SLURPD Administrator's Guide" for more details on
  50 using
  51 .I edb2ldif,
  52 including step-by-step conversion instructions.
  53 .SH OPTIONS
  54 .TP
  55 .B \-d
  56 Turn on some extra debugging which is written to standard error.
  57 .TP
  58 .B \-v
  59 Enable verbose mode that writes status information to standard error, such
  60 as which EDB file is being processed, how many entries have been
  61 converted so far, etc.
  62 .TP
  63 .B \-r
  64 Recurse through child directories, processing all EDB files found.
  65 .TP
  66 .B \-o
  67 Cause local
  68 .B .add
  69 file definitions to override the global addfile (see the
  70 .B \-a
  71 option below)
  72 .TP
  73 .BI \-b " basedn"
  74 Specify the Distinguished Name that all EDB file entries appear below.
  75 .TP
  76 .B \-a " addvalsfile"
  77 The LDIF information contained in this file will be appended to each entry.
  78 (See the
  79 .B \-o
  80 option above.)
  81 .TP
  82 .BI \-f " fileattrdir"
  83 Specify a single directory where all file-based attributes (typically sounds
  84 and images) can be found.  If this option is not given, file attributes are
  85 assumed to be located in the same directory as the EDB file that refers to
  86 them.
  87 .TP
  88 .BI \-i " ignoreattr"
  89 Specify an attribute that should not be converted.  You can include as many
  90 \- i flags as necessary.
  91 .SH "SEE ALSO"
  92 .BR ldap (3),
  93 .BR ldif (5),
  94 .BR slapd (8),
  95 .BR ldif2ldbm (8)
  96 .LP
  97 "The SLAPD and SLURPD Administrator's Guide"
  98 .LP
  99 Volume 5 of The ISODE Manual