Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for ldap_free_friendlymap (redhat section 3)

LDAP_FRIENDLY(3)		     Library Functions Manual			 LDAP_FRIENDLY(3)

NAME
       ldap_friendly_name,  ldap_free_friendlymap - LDAP unfriendly to friendly name mapping rou-
       tine

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/openldap/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/openldap/ldapfriendly.conf

SEE ALSO
       ldap(3)

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.

OpenLDAP 2.0.27-Release 		22 September 1998			 LDAP_FRIENDLY(3)


All times are GMT -4. The time now is 12:03 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password