Basic documentation for the getpass module.
authorFred Drake <fdrake@acm.org>
Tue, 22 Dec 1998 23:37:21 +0000 (23:37 +0000)
committerFred Drake <fdrake@acm.org>
Tue, 22 Dec 1998 23:37:21 +0000 (23:37 +0000)
Doc/lib/libgetpass.tex [new file with mode: 0644]

diff --git a/Doc/lib/libgetpass.tex b/Doc/lib/libgetpass.tex
new file mode 100644 (file)
index 0000000..4d7e8b9
--- /dev/null
@@ -0,0 +1,31 @@
+\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}