namemap(3I)                                              namemap(3I)


       NAME
             namemap - map a name

       SYNOPSIS
             cc [options] file -liaf
             #include <iaf.h>
             int namemap (char *scheme, char *g_name, char *logname);

       DESCRIPTION
             The namemap routine is used to map remote names into local
             identities.  It takes a remote user identification and the
             name of the ID mapping scheme as input and returns a
             corresponding local user login name.  scheme is the scheme
             name, g_name is the remote (global) name, and logname is the
             location where namemap places the local login name.

             To map the remote identity to a local one, namemap consults
             the uidata and idata map files associated with the scheme.
             When user-controlled mapping for a scheme is enabled by the
             system administrator, namemap consults uidata before idata,
             which causes user-specified entries to take precedence over
             system administrator mapping.  If user-controlled mapping for
             the scheme is disabled, only the scheme's idata file is
             consulted.

          Files
             /etc/idmap/scheme_name/idata    map file for scheme_name
             /etc/idmap/scheme_name/uidata   user-controlled map file for scheme_name
             /etc/passwd                     password file

          Return Values
             Upon successful completion, namemap returns 0; otherwise, it
             returns -1.

       REFERENCES
             attradmin(1M), idadmin(1M), namemap(3I), uidadmin(1)












                           Copyright 1994 Novell, Inc.               Page 1