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.