Program to check a pam username/password combination
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>".
This manual page was written by Timshel Knoll <[email protected]>, for the Debian GNU/Linux system (but may be used by others).