PASSWD(1)

NAME
       passwd - update a user's authentication tokens(s)

SYNOPSIS
       passwd [-u] [username]

DESCRIPTION
       Passwd is used to update a user's authentication token(s).

       Only the superuser may update another user's  password  by
       supplying a username.  The option, -u, is used to indicate
       that the update should only be for expired  authentication
       tokens  (passwords);  the  user  wishes to keep their non-
       expired tokens as before.

       Passwd is configured to work through  the  Linux-PAM  API.
       Essentially,  it  initializes itself as a "passwd" service
       with Linux-PAM and utilizes configured password modules to
       authenticate and then update a user's password.

       A  simple  entry  in  the Linux-PAM configuration file for
       this service would be:

        #
        # passwd service entry that does strength checking of
        # a proposed password before updating it.
        #
        passwd password requisite pam_cracklib.so retry=3
        passwd password required pam_pwdb.so use_authtok
        #

       Note, other module-types are not required for this  appli-
       cation to function correctly.

EXIT CODE
       On successful completion of its task, passwd will complete
       with exit code 0.  An exit code of 1  indicates  an  error
       occurred.   Textual  errors  are  written  to the standard
       error stream.

CONFORMING TO
       Linux-PAM (Pluggable Authentication modules for Linux).

FILES
       /etc/pam.conf - the Linux-PAM configuration file

BUGS
       None known.

SEE ALSO
       pam(8) and pam_chauthok(2). 

       For more complete information on  how  to  configure  this
       application  with  Linux-PAM,  see  the  Linux-PAM  System
       Administrators' Guide at
       <http://parc.power.net/morgan/Linux-PAM/index.html>