pam_open_session - open a user session
int pam_open_session ( pam_handle_t *pamh, int flags );
pam_open_session()function opens a new session for a user previously authenticated with a call to pam_authenticate().
If successful, the function returns [PAM_SUCCESS].
The arguments for
- pamh (in)
The PAM handle, which has been returned from a previous call to
- flags (in)
Flags may be set to PAM_SILENT to disable messages from the session service.
In many instances the
pam_open_session()and pam_close_session()calls may be made by different processes. For example, in UNIX the login process opens a session, while the init process closes the session. In this case the, UTMP/WTMP entries may be used to link the call to pam_close_session()with an earlier call to pam_open_session(). This is possible because UTMP/WTMP entries are uniquely identified by a combination of attributes, including the user login name and device name, which are accessible through the PAM handle, pamh. The call to pam_open_session()should precede UTMP/WTMP entry management and the call to pam_close_session()should follow UTMP/WTMP exit management.
The following PAM status codes shall be returned:
There has been a failure in creating or removing an entry for the specified session.
The caller does not possess the required authority.
Failure when dynamically loading a service module.
Symbol not found in service module.
Error in service module.
Memory buffer error.
[??] Some characters or strings that appear in the printed document are not easily representable using HTML.