---
name: "ldap_friendly"
section: "3"
platform: "linux"
package: "libldap2-dev"
version: "2.0.23-6.3"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/ldap_friendly"
---

# ldap\_friendly(3)

LDAP unfriendly to friendly name mapping routine

## NAME

ldap\_friendly\_name, ldap\_free\_friendlymap - LDAP unfriendly to friendly name mapping routine

## SYNOPSIS

```
#include <ldap.h>
```

**typedef struct ldap\_friendly {**\
         **char \*lf\_unfriendly;**\
         **char \*lf\_friendly;** **} LDAPFriendlyMap;**

**char \*ldap\_friendly\_name(filename, name, map)** **char \*filename;** **char \*name;** **LDAPFriendlyMap \*\*map;**

**void ldap\_free\_friendlymap(map)** **LDAPFriendlyMap \*\*map;**

## DESCRIPTION

**This routine is used to map one set of strings to another.  Typically,** **this is done for country names, to map from the two-letter country** **codes to longer more readable names.  The mechanism is general enough** **to be used with other things, though.**

*filename* **is the name of a file containing the unfriendly to** **friendly mapping,** *name* **is the unfriendly name to map to a friendly** **name, and** *map* **is a result-parameter that should be set to NULL** **on the first call.  It is then used to hold the mapping in core so that** **the file need not be read on subsequent calls.**

**For example:**

```
        LDAPFriendlyMap *map = NULL;
        printf( "unfriendly %s => friendly %s\n", name,
            ldap_friendly_name( "/usr/share/ldap/ldapfriendly", name, &map ) );
```

**The mapping file should contain lines like this: unfriendlyname\\tfriendlyname.** **Lines that begin with a '#' character are comments and are ignored.**

**The** **ldap\_free\_friendlymap()** **call is used to free structures allocated by** **ldap\_friendly\_name()** **when no more calls to** **ldap\_friendly\_name()** **are to be made.**

## ERRORS

**NULL is returned by** **ldap\_friendly\_name()** **if there is an error opening** *filename***, or if the file has a bad** **format, or if the** *map* **parameter is NULL.**

## FILES

**/usr/share/ldap/ldapfriendly.conf**

## SEE ALSO

[**ldap**(3)](/ldap/3.md)

## ACKNOWLEDGEMENTS

**OpenLDAP** **is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).** **OpenLDAP** **is derived from University of Michigan LDAP 3.3 Release.**