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(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|

SEE ALSO

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