1UNIX_CHKPWD(8)                 Linux-PAM Manual                 UNIX_CHKPWD(8)
2
3
4

NAME

6       unix_chkpwd  -  helper binary that verifies the password of the current
7       user
8

SYNOPSIS

10       /sbin/unix_chkpwd [username]
11
12

DESCRIPTION

14       unix_chkpwd is a helper program for the pam_unix module  that  verifies
15       the password of the current user.  It is not intended to be run direct‐
16       ly from the command line and logs a security violation if done so.
17
18       It is typically installed setuid root or setgid shadow.
19
20

OPTIONS

22       unix_pwdchk optionally takes the following argument:
23
24       username
25              The username of the user whose password you want to check:  this
26              must match the current user id.
27
28

INPUTS

30       unix_pwdchk expects the following inputs via stdin:
31
32       option Either  nullok or nonull, depending on whether the user can have
33              an empty password.
34
35       password
36              The password to verify.
37
38

RETURN CODES

40       unix_chkpwd has the following return codes:
41
42       1      unix_chkpwd was inappropriately called from the command line  or
43              the password is incorrect.
44
45
46       0      The password is correct.
47
48

HISTORY

50       Written by Andrew Morgan
51
52

SEE ALSO

54       pam(8)
55
56

AUTHOR

58       Emily Ratliff.
59
60
61
62
63Linux-PAM 0.76                    2003-03-21                    UNIX_CHKPWD(8)