Reads a password.
Standard C Library (libc.a)
char *getpass (Prompt) char *Prompt;
Attention: The characters are returned in a static data area. Subsequent calls to this subroutine overwrite the static data area.
The getpass subroutine does the following:
During the read operation, character echoing is disabled.
The getpass subroutine is not safe in a multithreaded environment. To use the getpass subroutine in a threaded application, the application must keep the integrity of each thread.
|Prompt||Specifies a prompt to display on the terminal.|
If this subroutine is successful, it returns a pointer to the string. If an error occurs, the subroutine returns a null pointer and sets the errno global variable to indicate the error.
If the getpass subroutine is unsuccessful, it returns one or more of the following error codes:
|EINTR||Indicates that an interrupt occurred while the getpass subroutine was reading the terminal device. If a SIGINT or SIGQUIT signal is received, the getpass subroutine terminates input and sends the signal to the calling process.|
|ENXIO||Indicates that the process does not have a controlling terminal.|
Note: Any subroutines called by the getpass subroutine may set other error codes.
This subroutine is part of Base Operating System (BOS) Runtime.
The getuserpw subroutine, newpass subroutine.
List of Security and Auditing Subroutines, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.