NAME    [Toc]    [Back]

       pw_nametoid,  pw_idtoname,  gr_nametoid, gr_idtoname - Map
       between user and group names and IDs (Enhanced Security)

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h> #include <prot.h>

       uid_t pw_nametoid(
               char *name ); char *pw_idtoname(
               uid_t id ); gid_t gr_nametoid(
               char *name ); char *gr_idtoname(
               gid_t id );

LIBRARY    [Toc]    [Back]

       Enhanced Security Library (libsecurity)

PARAMETERS    [Toc]    [Back]

       Specifies the  user  (pw_nametoid())  or  group  (gr_nametoid())
 name.  Specifies the user (pw_idtoname()) or group
       (gr_idtoname()) ID.

DESCRIPTION    [Toc]    [Back]

       The mapping functions provide an efficient mapping between
       user  and  group  names and identifiers (IDs). These functions
 maintain a separate binary database, which is  automatically
  updated  each  time  the  functions encounter a
       changed /etc/passwd or /etc/group file. Also, these  functions
 do not interfere with the behavior of the getpwent()
       and getgrent() functions, and are thus used  by  the  protected
  password database functions, which must frequently
       convert between names and identifiers but may not  disrupt
       an application's use of password mapping functions.

NOTES    [Toc]    [Back]

       Programs using these functions must be compiled with -lsecurity.

RETURN VALUES    [Toc]    [Back]

       Functions returning character strings return Null on failure,
  and  a  pointer to a string in an internal (that is,
       internal to the functions) memory area containing the user
       or  group  name  on  success. Functions returning integers
       return a nonnegative user or group ID  on  success,  or  a
       value of -1 on failure.

FILES    [Toc]    [Back]

       System password file.  System group file.

SEE ALSO    [Toc]    [Back]

       Functions: getgrent(3), getprpwent(3), getpwent(3)



                                                    pw_mapping(3)