PUTPWENT(3C) Standard C Library Functions PUTPWENT(3C)
putpwent - write password file entry
#include <pwd.h>
int putpwent(const struct passwd *p, FILE *f);
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.
The putpwent() function returns a non-zero value if an error was
detected during its operation. Otherwise, it returns 0.
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.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
getpwnam(3C), putspent(3C), attributes(7)
December 29, 1996 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)