1 .\" Copyright (C) 2003 International Business Machines Corporation
2 .\" This file is distributed according to the GNU General Public License.
3 .\" See the file COPYING in the top level source directory for details.
13 .de Sp \" Vertical space (when we can't use .PP)
19 .ie \\n(.$>=3 .ne \\$3
23 .TH "UNIX_CHKPWD" 8 "2003-03-21" "Linux-PAM 0.76" "Linux-PAM Manual"
25 unix_chkpwd \- helper binary that verifies the password of the current user
30 /sbin/unix_chkpwd [\fIusername\fR]
36 \fBunix_chkpwd\fR is a helper program for the pam_unix module that verifies
37 the password of the current user. It is not intended to be run directly from
38 the command line and logs a security violation if done so.
40 It is typically installed setuid root or setgid shadow.
44 unix_pwdchk optionally takes the following argument:
47 The username of the user whose password you want to check: this must match the current user id.
51 unix_pwdchk expects the following inputs via stdin:
54 Either nullok or nonull, depending on whether the user can have an empty password.
57 The password to verify.
61 \fBunix_chkpwd\fR has the following return codes:
64 unix_chkpwd was inappropriately called from the command line or the password is incorrect.
68 The password is correct.
71 Written by Andrew Morgan