GETPASS(3,L)                AIX Technical Reference                GETPASS(3,L)



-------------------------------------------------------------------------------
getpass



PURPOSE

Reads a password.

LIBRARY

Standard C Library (libc.a)

SYNTAX

char *getpass (prompt)
char *prompt;

DESCRIPTION

The getpass subroutine writes the prompt string to standard error output,
disables echoing, and reads up to a new-line character or EOF from the file
/dev/tty.

It returns a pointer to a null-terminated string of no more than eight
characters.  This return value points to data that is overwritten by successive
calls.  If the /dev/tty file cannot be opened, a NULL pointer is returned.

An interrupt terminates input and sends an interrupt signal to the calling
program before returning.

FILE

/dev/tty

ERROR CONDITIONS

The getpass subroutine fails if one or more of the following are true:

EINTR     The getpass subroutine was interrupted by a signal.

ENXIO     The process does not have a controlling terminal.

RELATED INFORMATION

In this book:  "crypt, encrypt, setkey."









Processed November 7, 1990       GETPASS(3,L)                                 1