getpwuid_r()--Get User Information for User ID

 #include <sys/types.h>
 #include <pwd.h>

 int getpwuid_r(uid_t uid, struct passwd *pwd,  
 char *buffer, size_t bufsize, struct passwd
 **result);

The getpwuid_r() function updates the passwd structure pointed to by pwd and stores a pointer to that structure in the location pointed to by result. The structure contains an entry from the user database with a matching uid.

Parameters

uid

(Input) User ID.

pwd

(Input) A pointer to a struct passwd.

buffer

(Input) A pointer to a buffer from which memory is allocated to hold storage areas referenced by the structure passwd.

bufsize

(Input) The size of buffer in bytes.

result

(Input) A pointer to a location in which a pointer to the updated passwd structure is stored. If an error occurs or if the requested entry cannot be found, a NULL pointer is stored in this location.

The struct passwd, which is defined in the pwd.h header file, has the following elements:

See QlgGetpwuid_r()--Get User Information for User ID (using NLS-enabled path name) for a description and an example where the path name is returned in any CCSID.

Authorities

*READ authority is required to the user profile associated with the UID. If the user does not have *READ authority, only the user name, user ID, and group ID values are returned.

Note: Adopted authority is not used.

Return Value

0

getpwuid_r() was successful.

Any other value

Failure: The return value contains an error number indicating the error.

Error Conditions

If getpwuid_r() is not successful, the error value usually indicates one of the following errors. Under some conditions, the value could indicate an error other than those listed here.

Usage Notes

The initial working directory is returned in the CCSID value of the job.

Related Information

• The <pwd.h> file (see Header Files for UNIX-Type Functions)
  
  
• getpwuid()--Get User Information for User ID

Example

See Code disclaimer information for information pertaining to code examples.

The following example gets the user database information for the UID of 22. The user name is MYUSER. The GID of MYUSER's first group is 1012. The initial directory is /home/MYUSER. The initial user program is *LIBL/QCMD.

#include <sys/types.h>
#include <pwd.h>
#include <stdio.h>
#include <errno.h>

main()
{
  struct passwd pd;
  struct passwd* pwdptr=&pd;
  struct passwd* tempPwdPtr;
  char pwdbuffer[200];
  int  pwdlinelen = sizeof(pwdbuffer);

  if ((getpwuid_r(22,pwdptr,pwdbuffer,pwdlinelen,&tempPwdPtr))!=0)
     perror("getpwuid_r() error.");
  else
  {
     printf("\nThe user name is: %s\n", pd.pw_name);
     printf("The user id   is: %u\n", pd.pw_uid);
     printf("The group id  is: %u\n", pd.pw_gid);
     printf("The initial directory is:    %s\n", pd.pw_dir);
     printf("The initial user program is: %s\n", pd.pw_shell);
  }

}

  The user name is: MYUSER
  The user ID   is: 22
  The group ID  is: 1012
  The initial directory is:    /home/MYUSER
  The initial user program is: *LIBL/QCMD