man.bsd.lv manual page server

DESCRIPTION

The password may be up to sysconf(3) _SC_PASS_MAX characters in length. Any additional characters and the terminating newline character are discarded.

getpass() turns off character echoing while reading the password.

getpass_r() is similar to getpass() only it puts its result in buf for up to buflen characters. If the buf argument is NULL, then a buffer will be dynamically allocated.

The getpassfd() function allows one to specify the three file descriptors corresponding to stdin, stdout, and stderr in the fd argument, or if fd is NULL, getpassfd() first attempts to open /dev/tty and if that fails, defaults to STDIN_FILENO for input and STDERR_FILENO for output.

The behavior of getpassfd() is controlled by the flags argument:

GETPASS_NEED_TTY

Fail if we are unable to set the tty modes like we want.

GETPASS_FAIL_EOF

Fail if we get the end-of-file character instead of returning the result so far.

GETPASS_BUF_LIMIT

Beep when the buffer limit is reached, instead of silently absorbing it.

GETPASS_NO_SIGNAL

Don't make ttychars send signals.

GETPASS_NO_BEEP

Don't beep if we erase past the beginning of the buffer or we try to enter past the end.

GETPASS_ECHO_STAR

Echo a ‘*’ for each character entered.

GETPASS_ECHO

Echo characters as they are typed.

GETPASS_ECHO_NL

Echoes a newline if successful.

GETPASS_7BIT

Mask the high bit for each entered character.

GETPASS_FORCE_LOWER

Lowercase each entered character.

GETPASS_FORCE_UPPER

Uppercase each entered character.

Finally if the timeout argument is non zero, getpassfd() will wait for timeout seconds for input after each character before returning an error, instead of waiting forever.