NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO
#include <unistd.h>char *getpass(const char *prompt);
The getpass() function opens the process's controlling terminal, writes to that device the null-terminated string prompt , disables echoing, reads a string of characters up to the next newline character or EOF, restores the terminal state and closes the terminal.
The function getpassphrase() is identical to getpass() , except that it will read and return a string of up to 256 characters in length.
Upon successful completion, getpass() returns a pointer to a null-terminated string of at most PASS_MAX bytes that were read from the terminal device. If an error is encountered, the terminal state is restored and a null pointer is returned.
The getpass() and getpassphrase() functions may fail if:
The function was interrupted by a signal.
The process is a member of a background process attempting to read from its controlling terminal, the process is ignoring or blocking
the SIGTTIN
signal or the process group is orphaned.
OPEN_MAX file descriptors are currently open in the calling process.
The maximum allowable number of files is currently open in the system.
The process does not have a controlling terminal.
The return value points to static data whose content may be overwritten by each call.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
MT-Level | Unsafe |
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO