seclib_passwd(3C)                                         seclib_passwd(3C)

NAME
     seclibpasswd - set a new user password as required

SYNOPSIS
     cc ... -lseclib

     #include <seclib.h>

     enum seclibreturnval
     seclibpasswd(enum secpassoptions, struct logincontext *);

DESCRIPTION
     The Password Setting Group is responsible for giving the user the
     opportunity to set a new password when their old one has expired or
     has not been set. The seclibpasswd() function checks for the follow-
     ing:

     -  SECPEXPIRED

        If the user's password is too old, but not to "very" old, change
        it. If the user's password is too "very" old, deny login.

     -  SECPPASSREQ

        If the user's password is NULL, set it.

     -  SECPWARNEXPIRE

        If the user's password will soon expire, warn them.

ARGUMENTS
     secpassoptions
          A bitmask that directs the function to enable particular
          features. The complete list of values in the bitmask may be found
          in the seclib.h header.

     logincontext
          A value as returned by secliblogincontext(). The structure
          referenced by this pointer contains all of the session informa-
          tion required to authenticate a user via the security library.

RETURN VALUE
     The functions return the seclibreturnval enumeration. The functions
     will return:

     SECROK
          The function completed processing without encountering a system
          error.

          NOTE: the function will return SECROK even if it sets
          context->reason to a failure value.




Page 1                       Reliant UNIX 5.44                Printed 11/98

seclib_passwd(3C)                                         seclib_passwd(3C)

     SECRCALLFAILED
          The function call failed. This is usually because a system call
          failed (such as a malloc() failing when a brk() call returned
          with an error).

     SECRBADOPTION
          The function was called with an invalid argument.

SEE ALSO
     seclib(3C), secliblogincontext(3C), seclibmisc(3C),
     seclibpassentry(3C), seclibpassqual(3C), seclibruserok(3C),
     seclibsecterm(3C), seclibtwindows(3C).










































Page 2                       Reliant UNIX 5.44                Printed 11/98