Doc/lib/libgetpass.tex

\section{\module{getpass}
         --- Portable password reading.}

\declaremodule{standard}{getpass}
\moduleauthor{Piers Lauder}{piers@cs.su.oz.au}
% Windows support by Guido van Rossum.
\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}

\modulesynopsis{Portable reading of passwords and retrieval of the userid.}


The \module{getpass} module provides two functions:


\begin{funcdesc}{getpass}{\optional{prompt}}
  Prompt the user for a password without echoing.  The user is
  prompted using the string \var{prompt}, which defaults to
  \code{'Password: '}.
\end{funcdesc}


\begin{funcdesc}{getuser}{}
  Return the ``login name'' of the user.

  This function checks the environment variables \envvar{LOGNAME},
  \envvar{USER}, \envvar{LNAME} and \envvar{USERNAME}, in order, and
  returns the value of the first one which is set to a non-empty
  string.  If none are set, the login name from the password database
  is returned on systems which support the \module{pwd} module,
  otherwise, an exception is raised.
\end{funcdesc}