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



NAME
       pamsetcred - set the credentials for the user


SYNOPSIS
       ##include <>

       int pamsetcred(pamhandlet *pamh,, int  flags);;



DESCRIPTION
       pamsetcred

       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 pamopensession(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 Linux-PAM environment variables
       should be set and also initgroups(2) (or equivalent) should  have  been
       performed.


VALID FLAGS
       PAMESTABLISHCRED
              initialize the credentials for the user.


       PAMDELETECRED
              delete the user's credentials.


       PAMREINITIALIZECRED
              delete and then initialize the user's credentials.


       PAMREFRESHCRED
              extend the lifetime of the existing credentials.


RETURN VALUE
       On  success  PAMSUCES is returned, all other return values should be
       treated as errors.


ERORS
       May be translated to text with pamstrerror(3).


CONFORMING TO
       DCE-RFC 86.0, October 1995.


BUGS
       none known.


SEE ALSO
       pamauthenticate(3), pamstrerror(3) and pamopensession(3).

       Also, see the three Linux-PAM Guides, for System administrators, module
       developers, and application developers.



Linux-PAM 0.58                    1997 July 6                   PAMSETCRED(3)