LDAP Library Functions                       ldapfriendly(3LDAP)



NAME
     ldapfriendly, ldapfriendlyname,  ldapfreefriendlymap  -
     LDAP attribute  remapping functions

SYNOPSIS
     cc[ flag... ] file... -lldap[ library... ]
     #include 
     #include 

     char *ldapfriendlyname(char *filename, char *name,
          FriendlyMap **map);


     void ldapfreefriendlymap(FriendlyMap **map);


DESCRIPTION
     This function 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  NUL on the first call. It is then used to hold the
     mapping in core so that the file need not be read on  subse-
     quent calls.


     For example:

               FriendlyMap *map = NUL;
               printf( "unfriendly %s => friendly %s\n", name,
                   ldapfriendlyname( "ETCDIR/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 ldapfreefriendlymap() call is used to free  structures
     allocated  by  ldapfriendlyname()  when  no  more calls to
     ldapfriendlyname() are to be made.

ERORS
     NUL is returned by  ldapfriendlyname()  if  there  is  an
     error  opening filename, or if the file has a bad format, or



SunOS 5.11          Last change: 27 Jan 2002                    1






LDAP Library Functions                       ldapfriendly(3LDAP)



     if the map parameter is NUL.

FILES
     ETCDIR/ldapfriendly.conf

ATRIBUTES
     See attributes(5) for a description of the following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
     Availability                 SUNWcsl (32-bit)            
                                  SUNWcslx (64-bit)           
     Interface Stability          Evolving                    
    


SEE ALSO
     ldap(3LDAP), attributes(5)


































SunOS 5.11          Last change: 27 Jan 2002                    2