HP-UX Directory Server Administrator Guide HP-UX Directory Server Version 8.1 (5900-3098, May 2013)

A LDAP data Interchange Format
HP-UX Directory Server (Directory Server) uses the LDAP Data Interchange Format (LDIF) to describe
a directory and directory entries in text format. LDIF is commonly used to build the initial directory
database or to add large numbers of entries to the directory all at once. In addition, LDIF is also
used to describe changes to directory entries. For this reason, most of Directory Server's command
line utilities rely on LDIF for either input or output.
Because LDIF is a text file format, LDIF files can be created using virtually any language. All directory
data is stored using the UTF-8 encoding of Unicode. Therefore, the LDIF files created must also be
UTF-8 encoded.
For information on using LDIF to modify directory entries, see “Creating Directory Entries” (page
96).
Topics include:
• “About the LDIF file format” (page 547)
• “Continuing lines in LDIF” (page 548)
• “Representing binary data” (page 548)
• “Specifying directory entries Using LDIF” (page 549)
• “Defining directories using LDIF” (page 551)
• “Storing information in multiple languages” (page 553)
A.1 About the LDIF file format
LDIF consists of one or more directory entries separated by a blank line. Each LDIF entry consists
of an optional entry ID, a required distinguished name, one or more object classes, and multiple
attribute definitions.
The LDIF format is defined in RFC 2849, The LDAP Data Interchange Format (LDIF). Directory Server
is compliant with this standard.
The basic form of a directory entry represented in LDIF is as follows:
dn: distinguished_name
objectClass: object_class
objectClass: object_class
...
attribute_type[;subtype]:attribute_value
...
• Every LDIF entry must have a DN and at least one object class definition.
• Include any attributes required by the object classes defined for the entry.
• All other attributes and object classes are optional.
• Object classes and attributes can be specified in any order.
• The space after the colon is optional.
Table 77 (page 547) describes the LDIF fields shown in the previous definition.
Table 77 LDIF fields
DefinitionField
Optional. A positive decimal number representing the entry ID. The database creation
tools generate this ID automatically. Never add or edit this value yourself.
[id]
Specifies the distinguished name for the entry.dn: distinguished_name
A.1 About the LDIF file format 547