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)
