hpux man page for pam_open_session

pam_open_session(3)					     Library Functions Manual					       pam_open_session(3)

NAME
       pam_open_session, pam_close_session - perform PAM session creation and termination operations

SYNOPSIS
       [ flag ... ] file ...  [ library ... ]

DESCRIPTION
       is  called  after  a user has been successfully authenticated (refer to pam_authenticate(3) and pam_acct_mgmt(3)) and is used to notify the
       session modules that a new session has been initiated.  All programs that use the pam(3) library should invoke when beginning  a  new  ses-
       sion.  Upon termination of this activity, should be invoked to inform pam(3) that the session has terminated.

       The pamh argument is an authentication handle obtained by a prior call to The following flag may be set in the flags field for and

       The session service should not generate any messages.

APPLICATION USAGE
       Refer to pam(3) for information on thread-safety of PAM interfaces.

RETURN VALUES
       Upon successful completion, is returned.  In addition to the return values defined in pam(3), the following value may be returned on error:

       Can not make/remove an entry for the specified session.

SEE ALSO
       pam(3), pam_start(3), pam_authenticate(3), pam_acct_mgmt(3).

															       pam_open_session(3)