.\" openfwtk project: getpassword.3 1-Nov-2000
.TH getpassword 3
.SH NAME
getpassword() \- get a password
.SH SYNOPSIS
.nf	
#include "fwfunc.h"
.fi
.sp 
char* \fBgetpassword\fP(const char *prompt)
.SH DESCRIPTION
The \fIgetpassword\fP function displays a prompt to stderr and reads in 
a password from the standard input.
.PP
The password may be up to _PASSWORD_LEN (system default) characters in
length.  Any additional characters and the terminating newline character
are discarded.
.PP
\fIgetpassword\fP turns off character echoing while reading the password.
.SH RETURN VALUES
The \fIgetpassword\fP function returns a pointer to the null terminated password.
.SH SEE ALSO
getpass(3)
.SH HISTORY
present in fwtk since v2