Novell Doc: LDAP Libraries for C - Destination Handler Options

1.4 Destination Handler Options

The destination handler options (-D) specify the destination of the export data. Only one of the following can be specified on the command line.

Table 1-7 Destination Handler Options

Option	Description
-DLDIF	Specifies that the destination is an LDIF file. For a list of supported options, see LDIF Destination Options
-DLDAP	Specifies that the destination is an LDAP server. For a list of supported options, see LDAP Destination Options.
-DDELIM	Specifies that the destination is a comma-delimited file. For a list of supported options, see DELIM Destination Options.

Option

Description

-DLDIF

Specifies that the destination is an LDIF file.

For a list of supported options, see LDIF Destination Options

-DLDAP

Specifies that the destination is an LDAP server.

For a list of supported options, see LDAP Destination Options.

-DDELIM

Specifies that the destination is a comma-delimited file.

For a list of supported options, see DELIM Destination Options.

Specific destination handler options are listed in the following sections:

1.4.1 LDIF Destination Options

The LDIF destination handler receives data from the source handler and writes it to an LDIF file.

Table 1-8 LDIF Destination Options

Option	Description
-f <LDIF file>	Specifies the filename where LDIF records can be written.
-v	Enables verbose mode of the handler.
-k	Generates the LDIF file in the current system locale.
-g <value>	Language of the LDIF file.

1.4.2 LDAP Destination Options

The LDAP destination handler receives data from the source handler and sends it to an LDAP server in the form of update operations to be performed by the server.

Table 1-9 LDAP Destination Options

Option	Description
-s <server name>	Specifies the DNS name or IP address of the LDAP server to which the handler binds and sends a search request. If this option is omitted, it defaults to the local host (127.0.0.1).
-p <port>	Specifies the integer port number of the LDAP server specified by the -s option. If this option is omitted, it defaults to 389.
-d <DN>	Specifies the distinguished name of the entry that should be used when binding to the server.
-w <password>	Specifies the password attribute of the entry specified by the -d option.
-B	Disables the use of asynchronous LBURP requests for transferring update operations to the server. The handler uses standard synchronous LDAP update operation requests instead. See Section 1.8, LDAP Bulk Update/Replication Protocol for more information.
-F	Allows the creation of forward references. When an entry is going to be created before its parent exists, a placeholder called a forward reference is created for the entry’s parent to allow the entry to be successfully created. If a later operation creates the parent, the forward reference is changed into a normal entry. For more information, see Section 1.9, Forward References.
-l	Stores password values using the simple password method of Novell's Modular Authentication Service (NMAS). Passwords are kept in a secure location in the directory, but key pairs are not generated until they are actually needed for authentication between servers. This improves the speed with which an object that has password information can be loaded.
-e <value>	Specifies which debugging flags should be enabled in the LDAP client SDK (see the client SDK for supported values).
-V <version>	Specifies the LDAP protocol version to be used for the connection. It must be 2 or 3. If this option is omitted, the default is 3.
-v	Enables verbose mode of the handler
-L <filename>	Specifies a file in DER format containing a server key to use for SSL authentication.
-Y <value>	Use SASL authentication (DIGEST-MD5 is the only supported mechanism currently).

1.4.3 DELIM Destination Options

The DELIM destination handler receives data from the source handler and writes it to a comma-delimited data file.

Table 1-10 DELIM Destination Options

Option	Description
-f <filename>	Specifies the filename where comma-delimited records can be written.
-v	Enables verbose mode of the handler.
-F <value>	Specifies a filename containing the attribute data order for the source data. If this option is not specified, you must enter this information directly using -t.
-t <value>	Comma-delimited list of attributes specifying the attribute data order for the source data. Either this option or -F must be specified.
-l <value>	Can be either RDN or DN. Specifies whether the driver should place the entire DN or just the RDN in the data. RDN is the default value.
-d <value>	Specifies the delimiter. The default delimiter is a comma (','). The following values are special case delimeters: [q] = quote (a single " as the delimeter) [t] = tab For example, to specify a tab as a delimiter, you would pass: -d[t]
-q <value>	Specifies the secondary delimiter. The default secondary delimiter is a single double quote ("). The following values are special case delimeters: [q] = quote (a single " as the delimeter) [t] = tab For example, to specify a tab as a delimiter, you would pass: -d[t]
-n <value>	Specifies a naming attribute to append during import, such as cn.

1.4.4 LOAD Destination Options

The LOAD handler cannot be used as an destination handler.