LSH-PAM-CHECKPW(8)

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).