14.21. Slapi_DN
#include "slapi-plugin.h" typedef struct slapi_dn Slapi_DN;
Slapi_DN is the data type for an opaque structure that represents a distinguished name in the server plug-in. The following table summarizes the front-end API functions that you can call to work with distinguished names.
| To ... | ... Call this function |
|---|---|
| Supply authentication information from an LDAP bind operation. | slapi_add_auth_response_control() |
| Specify a distinguished name is a root. | slapi_dn_isroot() |
| Convert a DN to canonical format and all characters to lower case | slapi_dn_normalize_case() |
| Normalize part of a DN value | slapi_dn_normalize_to_end() |
| Build the new DN of an entry. | slapi_moddn_get_newdn() |
| Add the RDN contained in a Slapi_RDN structure to the DN contained in a Slapi_DN structure. | slapi_sdn_add_rdn() |
| Compare two DNs. | slapi_sdn_compare() |
| Copy a DN. | slapi_sdn_copy() |
| Clear a Slapi_DN structure. | slapi_sdn_done() |
| Duplicate a Slapi_DN structure. | slapi_sdn_dup() |
| Free a Slapi_DN structure. | slapi_sdn_free() |
| Get the DN of the parent within a specific backend. | slapi_sdn_get_backend_parent() |
| Get the DN from a Slapi_DN structure. | slapi_sdn_get_dn() |
| Get the normalized DN of a Slapi_DN structure. | slapi_sdn_get_ndn() |
| Get the length of the normalized DN of a Slapi_DN structure. | slapi_sdn_get_ndn_len() |
| Get the parent DN of a given Slapi_DN structure. | slapi_sdn_get_parent() |
| Get the RDN from a normalized DN. | slapi_sdn_get_rdn() |
| Not implemented; do not use. Check if there is a RDN value that is a component of the DN structure. | slapi_sdn_is_rdn_component() |
| Check if there is a DN value stored in a Slapi_DN structure. | slapi_sdn_isempty() |
| Check if a DN is the parent of the parent of a DN. | slapi_sdn_isgrandparent() |
| Check if a DN is the parent of a DN. | slapi_sdn_isparent() |
| Check if a Slapi_DN structure contains a suffix of another. | slapi_sdn_issuffix() |
| Allocate new Slapi_DN structure. | slapi_sdn_new() |
| Create a new Slapi_DN structure. | slapi_sdn_new_dn_byref() |
| Create a new Slapi_DN structure. | slapi_sdn_new_dn_byval() |
| Create a new Slapi_DN structure. | slapi_sdn_new_dn_passin() |
| Create a new Slapi_DN structure. | slapi_sdn_new_ndn_byref() |
| Create a new Slapi_DN structure. | slapi_sdn_new_ndn_byval() |
| Check if an entry is in the scope of a certain base DN. | slapi_sdn_scope_test() |
| Set a DN value in a Slapi_DN structure. | slapi_sdn_set_dn_byref() |
| Set a DN value in a Slapi_DN structure. | slapi_sdn_set_dn_byval() |
| Set a DN value in a Slapi_DN structure. | slapi_sdn_set_dn_passin() |
| Set a normalized DN in a Slapi_DN structure. | slapi_sdn_set_ndn_byref() |
| Set a normalized DN in a Slapi_DN structure. | slapi_sdn_set_ndn_byval() |
| Set a new parent in an entry. | slapi_sdn_set_parent() |
| Set a new RDN for an entry. | slapi_sdn_set_rdn() |
| Convert the second RDN type value to the berval value. | slapi_rdn2typeval() |

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.