ldif2ldbm(1Mldap)
ldif2ldbm, ldif2index, ldif2id2entry, ldif2id2children --
LDIF-to-LDBM database format conversion utilities
Synopsis
/usr/bin/ldif2ldbm
-i ldif-input-file [-d debug-level]
[-f slapd-config-file] [-j number-of-jobs]
[-n databasenumber]
/usr/bin/ldif2index -i ldif-input-file
[-d debug-level] [-f slapd-config-file]
attribute-name [-n databasenumber]
/usr/bin/ldif2id2entry -i ldif-input-file
[-d debug-level] [-f slapd-config-file]
[-n databasenumber]
/usr/bin/ldif2id2children -i ldif-input-file
[-d debug-level] [-f slapd-config-file]
[-n databasenumber]
Description
These programs are used to convert a database in text LDIF
LDAP Directory Interchange Format (LDIF) to an
LDBM database suitable for use by
slapd(1Mldap).
Normally, only ldif2ldbm is invoked directly by the user. It will
invoke the other programs as necessary. Occasionally, it may be necessary
to invoke them by hand. For example, to create a new index file for an
existing database, the ldif2index program can be invoked. The
ldbmcat(1Mldap)
program is used to do the reverse conversion.
See
Configuring and administering LDAP
for more details on using these programs.
Options
The first three options apply to all four programs. The -j option
is only for the ldif2ldbm program.
- -i ldif-input-file
-
This option specifies the location of the LDIF input file containing
the database to convert. It is required.
- -d debug-level
-
Turn on debugging as defined by debug-level. Some general
operation and status messages are printed for any value of
debug-level. debug-level is taken as a bit string, with
each bit corresponding to a different kind of debugging information.
See <ldap.h> for details.
- -f slapd-config-file
-
This option specifies the slapd configuration file. The default
is /etc/slapd.conf.
- -j number-of-jobs
-
This option only applies to the ldif2ldbm program. It specifies
the level of parallelism to use when doing the conversion. ldif2ldbm
invokes several other programs during the conversion process, most notably
one invocation of ldif2index for each indexed attribute that
appears in the LDIF input file. The -j option tells
ldif2ldbm how many of these other programs it should run in
parallel. This can speed up the conversion, but beware of starting too
many processes in parallel, all competing for disk, memory, and CPU
resources. The default is 1.
- -n databasenumber
-
This option specifies the configuration file database for which to build
indices. The first database listed is ``1'', the second ``2'', and so on.
By default, the first LDBM database in the configuration file
is used.
Examples
To convert the file ldif.input into an LDBM database
with indexes, as described in the slapd configuration file
/etc/slapd.conf, type:
/usr/bin/ldif2index -i ldif.input -f /etc/slapd.conf
To do the same, but running two conversion sub-processes at a time, type:
/usr/bin/ldif2index -i ldif.input -f /etc/slapd.conf -j 2
References
Intro(3ldap),
ldbmcat(1Mldap),
ldif(4ldap),
slapd.conf(4ldap)
Configuring and administering LDAP
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.