text: PW_INIT(3) BSD Programmer's Manual PW_INIT(3)
  pw_init, pw_setdir, pw_file, pw_edit, pw_prompt, pw_copy, pw_scan, pw_error - utility functions for interactive passwd file updates
  #include <pwd.h> #include <util.h> void pw_init(); void pw_setdir(const char *directory); char * pw_file(const char *filename); void pw_edit(int notsetuid, const char *filename); void pw_prompt(); void pw_copy(int ffd, int tfd, const struct passwd *pw, const struct passwd *opw); int pw_scan(char *bp, struct passwd *pw, int *flags); void pw_error(const char *name, int err, int eval);a- bling most signals. The pw_setdir() function sets an alternative directory where the rest of the functions look for password-related files. Use this if you are writ- ing utilities that should be able to handle password files outside of /etc. The pw_file() function transforms filenames so that they end up in the directory specified to the latest pw_setdir() call. The rule is that all directories are stripped of the given name and only the filename is ap- pended to the directory. opw is not NULL, opw->pw_name will be used for matching instead. Additionally, if the existing entry does not match opw, the operation is aborted. The use of opw allows the caller to change the user name in an entry as well as guarantee that the entry being replaced has not changed in the meantime. The pw_scan() function accepts in bp a passwd entry as it would be represented is filled in with the following flags: _PASSWORD_NOUID The uid field of bp is empty. _PASSWORD_NOGID The gid field of bp is empty. _PASSWD_NOCHG The change field of bp is empty. _PASSWD_NOEXP The expire field of bp is empty. The pw_error() function displays an error message, aborts the current passwd update, and exits the current process. If err is non-zero, a warn- ing message beginning with name is printed for the current value of errno. The process exits with status eval.
  The pw_scan() function prints a warning message and returns 0 if the string in the bp argument is not a valid passwd string. Otherwise, pw_scan() returns 1.
  /etc/master.passwd /etc/ptmp
  pw_lock(3), passwd(5) MirOS BSD #10-current December.