Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

PXFGETPWNAM

POSIX Subroutine: Gets password information for a specified name. This routine is only available for Linux.

Module

USE IFPOSIX

CALL PXFGETPWNAM (name,ilen,jpasswd,ierror)

name

(Input) Character. The login name of the user to retrieve information about. For example, a login name might be "jsmith", while the actual name is "John Smith".

ilen

(Input) INTEGER(4). The length of the name string.

jpasswd

(Input) INTEGER(4). A handle of structure compnam.

ierror

(Output) INTEGER(4). The error status.

If successful, ierror is not changed; otherwise, an error code.

The PXFGETPWNAM subroutine stores the user information from /etc/passwd for the entry that matches the user name name in the structure associated with handle jpasswd.

NOTE:

To get a handle for an instance of the compnam structure, use PXFSTRUCTCREATE with the string 'compnam' for the structure name.

See Also