Content-type: text/html Man page of pw_mapping

pw_mapping

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

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

LIBRARY

Security Library (libsecurity.a)  

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 database 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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES
RETURN VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:15 GMT, October 02, 2010