Manual Pages for UNIX Operating System command usage for man putpwent

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.

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)












SunOS 5.11          Last change: 29 Dec 1996                    1