PUTPWENT(3C) Standard C Library Functions PUTPWENT(3C)
NAME
putpwent - write password file entry
SYNOPSIS
#include <pwd.h>
int putpwent(
const struct passwd *p,
FILE *f);
DESCRIPTION
The
putpwent() function is the inverse of
getpwent(). See
getpwnam(3C).
Given a pointer to a
passwd structure created by
getpwent(),
getpwuid(),
or
getpwnam(),
putpwent() writes a line on the stream
f that matches the
format of
/etc/passwd.
RETURN VALUES
The
putpwent() function returns a non-zero value if an error was detected
during its operation. Otherwise, it returns
0.
USAGE
The
putpwent() function is of limited utility, since most password files
are maintained as Network Information Service (NIS) files that cannot be
updated with this function. For this reason, the use of this function is
discouraged. If used at all, it should be used with
putspent(3C) to
update the shadow file.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
getpwnam(3C),
putspent(3C),
attributes(7) December 29, 1996
PUTPWENT(3C)