osf1 man page for pw_mapping

pw_mapping(3)						     Library Functions Manual						     pw_mapping(3)

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

LIBRARY
       Security Library - libsecurity.so

SYNOPSIS
       #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);

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

DESCRIPTION
       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 data-
       base functions, which must frequently convert between names and identifiers but may not disrupt an application's use  of  password  mapping
       functions.

NOTES
       Programs using these functions must be compiled with -lsecurity.

RETURN VALUES
       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
       System password file.  System group file.

RELATED INFORMATION
       Functions: getgrent(3), getprpwent(3), getpwent(3).  delim off

																     pw_mapping(3)