Retrieves a user's /etc/passwd file entry.
Standard C Library (libc.a)
int getpw (UserID, Buffer)
uid_t UserID char *Buffer
The getpw subroutine opens the /etc/passwd file and returns, in the Buffer parameter, the /etc/passwd file entry of the user specified by the UserID parameter.
| Buffer | Specifies a character buffer large enough to hold any /etc/passwd entry. |
| UserID | Specifies the ID of the user for which the entry is desired. |
The getpw subroutine returns:
| 0 | Successful completion |
| -1 | Not successful. |