PAM Library Functions                           pamsetcred(3PAM)



NAME
     pamsetcred - modify  or  delete  user  credentials  for  an
     authentication service

SYNOPSIS
     cc [ flag ... ] file ... -lpam [ library ... ]
     #include 



     int pamsetcred(pamhandlet *pamh, int flags);


DESCRIPTION
     The pamsetcred() function is used to establish, modify,  or
     delete  user  credentials.  It is typically called after the
     user has been authenticated and after  a  session  has  been
     validated.        See       pamauthenticate(3PAM)       and
     pamacctmgmt(3PAM).


     The user is specified by a  prior  call  to  pamstart()  or
     pamsetitem(), and is referenced by the authentication han-
     dle, pamh. The following flags  may  be  set  in  the  flags
     field.    Note  that  the  first  four  flags  are  mutually
     exclusive:

     PAMESTABLISHCRED       Set user credentials for an authen-
                              tication service.


     PAMDELETECRED          Delete user credentials  associated
                              with an authentication service.


     PAMREINITIALIZECRED    Reinitialize user credentials.


     PAMREFRESHCRED         Extend  lifetime  of  user  creden-
                              tials.


     PAMSILENT               Authentication service  should  not
                              generate any messages.



     If no flag  is  set,   PAMESTABLISHCRED  is  used  as  the
     default.

RETURN VALUES




SunOS 5.11          Last change: 10 Jan 2008                    1






PAM Library Functions                           pamsetcred(3PAM)



     Upon success, pamsetcred() returns  PAMSUCES.  In  addi-
     tion  to  the error return values described in pam(3PAM) the
     following values may be returned upon error:

     PAMCREDUNAVAIL    Underlying  authentication  service  can
                         not  retrieve  user credentials unavail-
                         able.


     PAMCREDEXPIRED    User credentials expired.


     PAMUSERUNKNOWN    User unknown to  underlying  authentica-
                         tion service.


     PAMCREDER        Failure setting user credentials.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability           Committed                  
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     pam(3PAM),   pamacctmgmt(3PAM),    pamauthenticate(3PAM),
     pamsetitem(3PAM),  pamstart(3PAM),  libpam(3LIB),  attri-
     butes(5)

NOTES
     The interfaces in libpam are MT-Safe  only  if  each  thread
     within  the  multithreaded application uses its own PAM han-
     dle.












SunOS 5.11          Last change: 10 Jan 2008                    2