Standard C Library Functions                         putpwent(3C)



NAME
     putpwent - write password file entry

SYNOPSIS
     #include 

     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.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


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












SunOS 5.11          Last change: 29 Dec 1996                    1