unix2_chkpwd(8)

unix2_chkpwd8

Helper binary that verifies the password of the current user

Usage

/sbin/unix2_chkpwd servicename username

Overview

unix2_chkpwd is a helper program for applications that verifies the password of the current user. It is not intended to be run directly from the command line and logs a security violation if done so.

It is typically installed setuid root or setgid shadow and called by applications, which only wishes to do an user authentication and nothing more.

Options

unix2_pwdchk requires the following arguments:

pam_service

The name of the service using unix2_chkpwd. This is required to be one of the services in /etc/pam.d

username

The name of the user whose password you want to verify.

Inputs

unix2_pwdchk expects the password via stdin.

Return codes

unix2_chkpwd has the following return codes:

1

unix2_chkpwd was inappropriately called from the command line or the password is incorrect.

0

The password is correct.

Releases

3 releases since Debian 5.0 (Lenny); the text changed 1 time.

  1. 5.0–6.0
  2. 7

History

Written by Olaf Kirch loosely based on unix_chkpwd by Andrew Morgan

Author

Emily Ratliff.

From libpam-unix2 1:2.4.1-6 in Debian 7 (Wheezy). Parsed by carta from the page's man source.