User Specifies the name of the user for which password information is read. If successful, the getuserpw subroutine returns a valid pointer to a pw structure. Otherwise, a null pointer is returned and the errno global variable is set to indicate the error. If successful, the putuserpwhist subroutine returns a value of 0. If the subroutine was unable to update the password history database, a message is returned in the Message parameter and a return code of 0 is returned.
Subroutines invoked by the getuserpw, putuserpw, or putuserpwhist subroutines can also set errors.
The getgroupattr subroutine, getuserattr , IDtouser , nextuser , or putuserattr subroutine, setpwdb or endpwdb subroutine, setuserdb subroutine. Writing and Debugging Programs .