Chapter Contents |
Previous |
Next |
getpwuid |
Portability: | POSIX.1 conforming, UNIX compatible |
SYNOPSIS | |
DESCRIPTION | |
RETURN VALUE | |
EXAMPLE | |
RELATED FUNCTIONS |
SYNOPSIS |
#include <sys/types.h> #include <pwd.h> struct passwd *getpwuid(uid_t uid);
DESCRIPTION |
getpwuid
returns a pointer to the
passwd
structure.
passwd
maps an entry in the user database.
uid
is the user ID for which information is to be
returned.
passwd
is defined in
<pwd.h>
.
It contains the following members:
pw_name
|
user name |
pw_uid
|
user ID number |
pw_dir
|
initial working directory |
pw_shell
|
initial user program. |
RETURN VALUE |
getpwuid
returns a pointer to the user database entry if successful.
Note that the pointer returned by
getpwuid
may be a static data area that can be rewritten by the next
call to
getpwnam
or
getpwuid
.
getpwuid
returns a
NULL
pointer if unsuccessful.
EXAMPLE |
The following code fragment illustrates
the use of
getpwuid
to
obtain a pointer to a
passwd
structure:
#include <sys/types.h> #include <pwd.h> #include <stdio.h> . . . struct passwd *p; uid_t uid=z0; if ((p = getpwuid(uid)) == NULL) perror("getpwuid() error"); else { printf("getpwuid returned the following name and directory for user ID %d:\n", (int) uid); printf("pw_name : %sn", p-> pw_name); printf("pw_dir : %dn", p-> pw_dir); } . . .
RELATED FUNCTIONS |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.