opensolaris man page for putpwent

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(), getp-
       wuid(), 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 put-
       spent(3C) to update the shadow file.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       getpwnam(3C), putspent(3C), attributes(5)

SunOS 5.11							    29 Dec 1996 						      putpwent(3C)