mirror/openldap
2
0
Fork 0
mirror of https://git.openldap.org/openldap/openldap.git synced 2025-03-07 14:18:15 +08:00
Code Issues Packages Projects Releases Wiki Activity

LDAPext I-D updates

Browse Source
This commit is contained in:
Kurt Zeilenga 2001-07-23 04:12:58 +00:00
parent 3a2f9e84ba
commit 01e8c6e3e4
1 changed files with 13 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/man/man3/ldap_get_dn.3
View File

@ -10,27 +10,16 @@ ldap_get_dn, ldap_explode_dn, ldap_explode_rdn, ldap_dn2ufn \- LDAP DN handling
#include <ldap.h> #include <ldap.h>
.LP .LP
.ft B .ft B
char *ldap_get_dn(ld, entry) char *ldap_get_dn( LDAP *ld, LDAPMessage *entry )
.ft
LDAP *ld;
LDAPMessage *entry;
.LP .LP
.ft B .ft B
char **ldap_explode_dn(dn, notypes) char **ldap_explode_dn( const char *dn, int notypes )
.ft
char *dn;
int notypes;
.LP .LP
.ft B .ft B
char **ldap_explode_rdn(rdn, notypes) char **ldap_explode_rdn( const char *rdn, int notypes )
.ft
char *rdn;
int notypes;
.LP .LP
.ft B .ft B
char *ldap_dn2ufn(dn) char *ldap_dn2ufn( const char * dn )
.ft
char *dn;
.SH DESCRIPTION .SH DESCRIPTION
These routines allow LDAP entry names (Distinguished Names, or DNs) These routines allow LDAP entry names (Distinguished Names, or DNs)
to be obtained, parsed, converted to a user-friendly form, and tested. to be obtained, parsed, converted to a user-friendly form, and tested.
@ -70,18 +59,19 @@ Similarly, the
routine takes an RDN as returned by routine takes an RDN as returned by
.B ldap_explode_dn(dn,0) .B ldap_explode_dn(dn,0)
and breaks it up into its "type=value" component parts (or just "value", 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 if the \fInotypes\fP parameter is set). Note the value is not
calling unescaped. The result can be freed by calling
.BR ldap_value_free (3). .BR ldap_value_free (3).
.LP .LP
.B ldap_dn2ufn() .B ldap_dn2ufn()
is used to turn a DN as returned by is used to turn a DN as returned by
.B ldap_get_dn() .BR ldap_get_dn (3)
into a more user-friendly form, stripping off type names. See into a more user-friendly form, stripping off all type names. See
RFC 1781 "Using the Directory to Achieve User Friendly Naming" "Using the Directory to Achieve User Friendly Naming" (RFC 1781)
for more details on the UFN format. The space for the UFN returned for more details on the UFN format. Due to the ambigious nature
is obtained dynamically and the user is responsible for freeing it of the format, it is generally only used for display purposes.
via a call to 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). .BR ldap_memfree (3).
.SH ERRORS .SH ERRORS
If an error occurs in If an error occurs in