NAME

       lsh-pam-checkpw - program to check a PAM username/password combination

SYNOPSIS

       lsh-pam-checkpw username-to-check

DESCRIPTION

       This  manual  page  documents  briefly  the lsh-pam-checkpw command.  This manual page was
       written for the Debian distribution because the original program does not  have  a  manual
       page.  Instead, it has documentation in the GNU Info format; see below.

       lsh-pam-checkpw  is  a program that checks if a username and password combination is valid
       for login by doing a PAM lookup. It is designed to be used as a  password  helper  program
       for lshd (8), (eg.  --password-helper=/usr/sbin/lsh-pam-checkpw.

       lsh-pam-checkpw takes one required argument, which is the username, and reads the password
       from stdin, then returns 0 if the password  is  valid,  or  1  otherwise.  Note  that  the
       password  must be supplied exactly, ie. there must be no newline after the password, so if
       invoking from a shell, just type "<your-password><CTRL-D>".

SEE ALSO

       lsh(1), lshd(8).   The programs are documented  fully  by  Lsh,  available  via  the  Info
       system.

AUTHOR

       This  manual  page  was  written  by  Timshel  Knoll  <timshel@debian.org>, for the Debian
       GNU/Linux system (but may be used by others).