NAME

putpwent() − write password file entry

SYNOPSIS

#include <pwd.h>

#include <stdio.h>

int putpwent(const struct passwd *p, FILE *f);

DESCRIPTION

putpwent() is the inverse of getpwent() (see getpwent(3C)). Given a pointer to a passwd structure as created by getpwent(), getpwuid(), or getpwnam(); putpwent() writes a line on the stream f, which matches the format of /etc/passwd. 

putpwent() ignores the audit ID and audit flag in the passwd structure; and does not create the corresponding entries used in the protected password database, used for trusted systems.  putprpwnam(), which produces entries that match the trusted password database file format, must be used to create these entries.  See getprpwent(3).

DIAGNOSTICS

putpwent() returns non-zero if an error was detected during its operation; otherwise it returns zero. 

FILES

/etc/passwd System Password file

SEE ALSO

getpwent(3C), putprpwent(3), passwd(4), prpwd(4), stdio(3S), fopen(3S). 

STANDARDS CONFORMANCE

putpwent(): SVID2, SVID3, XPG2
 
 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996