.\" Hey Emacs! This file is -*- nroff -*- source. .\" (above from Rik Faith..:*) .\" Copyright (c) Andrew G. Morgan 1996, .\" .TH PASSWD 1 "1996 Dec 14" "SimplePAMApps 0.50" "PAM only applications" .SH NAME passwd \- update a user's authentication tokens(s) .SH SYNOPSIS .B passwd [-u] [username] .sp 2 .SH DESCRIPTION Passwd is used to update a user's authentication token(s). .sp Only the superuser may update another user's password by supplying a .BR username ". " The option, .BR -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. .sp Passwd is configured to work through the .BR "Linux-PAM API" ". " Essentially, it initializes itself as a "passwd" service with .I Linux-PAM and utilizes configured .I "password" modules to authenticate and then update a user's password. .sp A simple entry in the .I Linux-PAM configuration file for this service would be: .br .br # .br # passwd service entry that does strength checking of .br # a proposed password before updating it. .br # .br passwd password requisite pam_cracklib.so retry=3 .br passwd password required pam_pwdb.so use_authtok .br # .sp Note, other module-types are not required for this application to function correctly. .SH "EXIT CODE" On successful completion of its task, .B 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. .SH "CONFORMING TO" .br .BR Linux-PAM (Pluggable Authentication modules for Linux). .SH "FILES" .br .B /etc/pam.conf - the .BR Linux-PAM configuration file .SH BUGS .sp 2 None known. .SH "SEE ALSO" .BR pam "(8), " and .BR pam_chauthok "(2). " .sp For more complete information on how to configure this application with .BR Linux-PAM ", " see the .BR "Linux-PAM System Administrators' Guide" " at " .br .I ""