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).
APPLICATION USAGE
putpwent()
is thread-safe. It is not async-cancel-safe.
A cancellation point may occur when a thread is executing
putpwent().
DIAGNOSTICS
putpwent()
returns non-zero if an error was detected during its operation;
otherwise it returns zero.
FILES
- /etc/passwd
System Password file
STANDARDS CONFORMANCE
putpwent(): SVID2, SVID3, XPG2
