putspent(3C)

NAME

     putspent - write shadow password file entry

SYNOPSIS

     #include <shadow.h>

     int putspent(const struct spwd *p, FILE *fp);

DESCRIPTION

     The  putspent() function is the inverse of  getspent().  See
     getspnam(3C). Given a pointer to a spwd structure created by
     getspent() or getspnam(), putspent() writes a  line  on  the
     stream fp that matches the format of /etc/shadow.

     The spwd structure contains the following members:

     char            *sp_namp;
     char            *sp_pwdp;
     long            sp_lstchg;
     long            sp_min;
     long            sp_max;
     long            sp_warn;
     long            sp_inact;
     long            sp_expire;
     unsigned long   sp_flag;

     If the sp_min,  sp_max,  sp_lstchg,  sp_warn,  sp_inact,  or
     sp_expire member of the  spwd structure is -1, or if sp_flag
     is 0, the corresponding  /etc/shadow field is cleared.

RETURN VALUES

     The  putspent() function returns  a  non-zero  value  if  an
     error  was  detected  during  its  operation.  Otherwise, it
     returns 0.

USAGE

     Since this function is for internal use only,  compatibility
     is  not guaranteed. For this reason, its use is discouraged.
     If used at all, if  should  be  used  with  putpwent(3C)  to
     update the password file.

ATTRIBUTES

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

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

SEE ALSO

     getpwnam(3C), getspnam(3C), putpwent(3C), attributes(5)