Commit 72a55aa4 authored by Kurt Zeilenga's avatar Kurt Zeilenga
Browse files

Leave dn2ufn.

parent 6cb35c0d
......@@ -3,7 +3,7 @@
.\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
ldap_get_dn, ldap_explode_dn, ldap_explode_rdn \- LDAP DN handling routines
ldap_get_dn, ldap_explode_dn, ldap_explode_rdn, ldap_dn2ufn \- LDAP DN handling routines
.ft B
......@@ -26,6 +26,11 @@ char **ldap_explode_rdn(rdn, notypes)
char *rdn;
int notypes;
.ft B
char *ldap_dn2ufn(dn)
char *dn;
These routines allow LDAP entry names (Distinguished Names, or DNs)
to be obtained, parsed, converted to a user-friendly form, and tested.
......@@ -68,6 +73,16 @@ and breaks it up into its "type=value" component parts (or just "value",
if the \fInotypes\fP parameter is set). The result can be freed by
.BR ldap_value_free (3).
.B ldap_dn2ufn()
is used to turn a DN as returned by
.B ldap_get_dn()
into a more user-friendly form, stripping off type names. See
RFC 1781 "Using the Directory to Achieve User Friendly Naming"
for more details on the UFN format. The space for the UFN returned
is obtained dynamically and the user is responsible for freeing it
via a call to
.BR ldap_memfree (3).
If an error occurs in
.BR ldap_get_dn() ,
......@@ -76,8 +91,10 @@ NULL is returned and the
field in the \fIld\fP parameter is set to indicate the error. See
.BR ldap_error (3)
for a description of possible error codes.
.BR ldap_explode_dn() and
.B ldap_explode_rdn()
.BR ldap_explode_dn() ,
.BR ldap_explode_rdn() ,
.B ldap_dn2ufn()
will return NULL with
.BR errno (3)
set appropriately in case of trouble.
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment