PAMSETCRED(3) App. Programmers' Manual PAMSETCRED(3)

NAME
       pamsetcred - set the credentials for the user


SYNOPSIS
       ##iinncclluuddee <>

       iinntt ppaammsseettccrreedd((ppaammhhaannddlleett *pamh,, iinntt  flags));;



DESCRIPTION
       ppaammsseettccrreedd

       This function is used to establish, maintain and delete the credentials
       of a user. It should be called after a user has been authenticated  and
       before a session is opened for the user (with ppaammooppeennsseessssiioonn(3)).

       It  should  be  noted  that  credentials  come  in many forms. Examples
       include: group memberships;  ticket-files;  and  Linux-PAM  environment
       variables.  For this reason, it is important that the basic identity of
       the user is established, by the application, prior to a  call  to  this
       function.   For  example,  the  default LLiinnuuxx-PPAAMM environment variables
       should be set and also iinniittggrroouuppss(2) (or equivalent) should  have  been
       performed.


VVAALLIIDD FFLLAAGGSS
       PPAAMMEESSTTAABBLLIISSHHCCRREEDD
              initialize the credentials for the user.


       PPAAMMDDEELLEETTEECCRREEDD
              delete the user's credentials.


       PPAAMMRREEIINNIITTIIAALLIIZZEECCRREEDD
              delete and then initialize the user's credentials.


       PPAAMMRREEFFRREESSHHCCRREEDD
              extend the lifetime of the existing credentials.


RREETTUURRNN VVAALLUUEE
       On  success  PPAAMMSSUUCCCCEESSSS is returned, all other return values should be
       treated as errors.


EERRRROORRSS
       May be translated to text with ppaammssttrreerrrroorr(3).


CCOONNFFOORRMMIINNGG TTOO
       DCE-RFC 86.0, October 1995.


BUGS
       none known.


SEE ALSO
       ppaammaauutthheennttiiccaattee(3), ppaammssttrreerrrroorr(3) and ppaammooppeennsseessssiioonn(3).

       Also, see the three LLiinnuuxx-PPAAMM Guides, for SSyysstteemm aaddmmiinniissttrraattoorrss, mmoodduullee
       ddeevveellooppeerrss, and aapppplliiccaattiioonn ddeevveellooppeerrss.



Linux-PAM 0.58                    1997 July 6                   PAMSETCRED(3)