getpwuid()--Get User Information for User ID

   #include <pwd.h>

   struct passwd *getpwuid(uid_t uid);    

The getpwuid() function returns a pointer to an object of type struct passwd containing an entry from the user database with a matching UID.

Parameters

uid

(Input) User ID.

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

struct passwd *

getpwuid() was successful. The return value points to static data of the format struct passwd, which is defined in the pwd.h header file. This storage is overwritten on each call to this function. This static storage area is also used by the getpwnam() function. The struct passwd has the following elements:

char *	pw_name	User name
uid_t	pw_uid	User ID
uid_t	pw_gid	Group ID of the user's first group. If the user does not have a first group, the gid value will be set to 0.
char *	pw_dir	Initial working directory. If the user does not have *READ authority to the user profile, the pw_dir pointer will be set to NULL.
char *	pw_shell	Initial user program. If the user does not have *READ authority to the user profile, the pw_shell pointer will be set to NULL.

NULL pointer

getpwuid() was not successful. The errno global variable is set to indicate the error.

See QlgGetpwuid()--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.

Error Conditions

If getpwuid() is not successful, errno usually indicates one of the following errors. Under some conditions, errno 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_r()--Get User Information for User ID
  
• QlgGetpwuid()--Get User Information for User ID (using NLS-enabled path name)

Example

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.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#include <pwd.h>

main()
{
  struct passwd *pd;

  if (NULL == (pd = getpwuid(22)))
     perror("getpwuid() error.");
  else
  {
     printf("The 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);
  }

}

Output:

  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

[ Back to top | UNIX-Type APIs | APIs by category ]