Chapter Contents

Previous

Next
getpwuid

getpwuid



Access User Database by User ID

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

getgrgid , getpwnam


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.