---
name: "lsh-pam-checkpw"
section: "8"
platform: "linux"
package: "lsh-server"
version: "2.1-13+b1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/lsh-pam-checkpw"
---

# lsh-pam-checkpw(8)

program to check a PAM username/password combination

## 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)](/lsh/1.md), [**lshd**(8)](/lshd/8.md). 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).