[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    putspent(3C) manual page Table of Contents

Name

putspent - write shadow password file entry

Synopsis

#include <shadow.h>

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

MT-Level

Unsafe

Description

The putspent() routine is the inverse of getspent(). Given a pointer to a spwd structure created by the getspent() routine (or the getspnam() routine), the putspent() routine writes a line on the stream fp, which 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 field of the spwd structure is -1, or if sp_flag is 0, the corresponding /etc/shadow field is cleared.

Return Values

The putspent() routine returns non-zero if an error was detected during its operation, otherwise zero.

See Also

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

Notes

This routine is for internal use only, compatibility is not guaranteed.

Do not use without also using putpwent() to update the password file.

The use of this function is discouraged.


Table of Contents