Issue 8113 - Missing man page information for ldap_str2dn
Summary: Missing man page information for ldap_str2dn
Status: VERIFIED INVALID
Alias: None
Product: OpenLDAP
Classification: Unclassified
Component: documentation (show other issues)
Version: unspecified
Hardware: All All
: --- normal
Target Milestone: ---
Assignee: OpenLDAP project
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-04-22 23:22 UTC by Quanah Gibson-Mount
Modified: 2020-09-17 20:14 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description Quanah Gibson-Mount 2015-04-22 23:22:04 UTC
Full_Name: Quanah Gibson-Mount
Version: RE24
OS: NA
URL: ftp://ftp.openldap.org/incoming/
Submission from: (NULL) (75.111.52.177)


According to a code comment, ldap_explode_rdn is deprecated, and the replacement
is ldap_str2dn

However, there is no man page info for ldap_str2dn
Comment 1 Quanah Gibson-Mount 2017-04-12 16:39:09 UTC
moved from Incoming to Documentation
Comment 2 jscott 2020-09-17 15:43:41 UTC
This has been fixed. It's in my manpage on Debian Bullseye:

ldap_str2dn() parses a string representation of a distinguished name contained in str into its components, which are stored  in  as  ldap_ava  structures,  arranged in LDAPAVA, LDAPRDN, and LDAPDN terms.  Space for dn will be obtained dynamically and should be freed by the caller using ldap_dnfree(3). The LDAPDN is defined as:
Comment 3 Quanah Gibson-Mount 2020-09-17 15:51:25 UTC
It's definitely not fixed.

While it is a part of the ldap_get_dn.3 man page, the installation piece that's supposed to create a link to that man page for the ldap_str2dn function is not working.
Comment 4 Howard Chu 2020-09-17 15:54:37 UTC
(In reply to Quanah Gibson-Mount from comment #3)
> It's definitely not fixed.
> 
> While it is a part of the ldap_get_dn.3 man page, the installation piece
> that's supposed to create a link to that man page for the ldap_str2dn
> function is not working.

According to commits, this has been in place since 2001. This bug report is invalid.

Note:
make install DESTDIR=/tmp/xman
...
installing ldap_get_dn.3 in /tmp/xman/usr/local/share/man/man3
installing ldap_explode_dn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_explode_rdn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dn2ufn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_str2dn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dnfree.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dn2str.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dn2dcedn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dcedn2dn.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
installing ldap_dn2ad_canonical.3 in /tmp/xman/usr/local/share/man/man3 as link to ldap_get_dn.3
...
Comment 5 Quanah Gibson-Mount 2020-09-17 15:55:38 UTC
In fact, for the ldap_get_dn.3.links file, only the first three links are created, the rest are not:

Links file has:

ldap_explode_dn.3
ldap_explode_rdn.3
ldap_dn2ufn.3
ldap_str2dn.3
ldap_dnfree.3
ldap_dn2str.3
ldap_dn2dcedn.3
ldap_dcedn2dn.3
ldap_dn2ad_canonical.3


on an installation:

[root@tx02 man3]# ls ldap_explode*
ldap_explode_dn.3  ldap_explode_rdn.3
[root@tx02 man3]# ls ldap_dn2ufn*
ldap_dn2ufn.3

[root@tx02 man3]# ls ldap_str2dn.3
ls: cannot access ldap_str2dn.3: No such file or directory
[root@tx02 man3]# ls ldap_dnfree.3
ls: cannot access ldap_dnfree.3: No such file or directory
[root@tx02 man3]# ls ldap_dn2dcedn.3
ls: cannot access ldap_dn2dcedn.3: No such file or directory

(etc)
Comment 6 Quanah Gibson-Mount 2020-09-17 15:57:49 UTC
Never mind, bug with the build of OpenLDAP I was using.