pw_mapping(3) [osf1 man page]
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)
Check Out this Related Man Page
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)