HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
p
pam_open_session(3) pam_open_session(3)
NAME
pam_open_session, pam_close_session - perform PAM session creation and termination operations
SYNOPSIS
cc [ flag ... ] file ... -lpam [ library ... ]
#include <security/pam_appl.h>
int pam_open_session(pam_handle_t
*pamh, int flags);
int pam_close_session(pam_handle_t
*pamh, int flags);
DESCRIPTION
pam_open_session() 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 pam_open_session()
when beginning a new session. Upon termination of this activity, pam_close_session() 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
pam_start() . The following
flag may be set in the flags field for
pam_open_session( )
and pam_close_session()
:
PAM_SILENT The session service should not generate any messages.
APPLICATION USAGE
No PAM functions are safe to be called by a multithreaded application.
RETURN VALUES
Upon successful completion, PAM_SUCCESS is returned. In addition to the return values defined in
pam(3), the following value may be returned on error:
PAM_SESSION_ERR Can not make/remove an entry for the specified session.
SEE ALSO
pam(3), pam_start(3), pam_authenticate(3), pam_acct_mgmt(3).
HP-UX Release 11i: December 2000 − 1 − Section 3−−593
___
___