PAM_OPEN_SESSION

---

NAME
pam_open_session − start PAM session management

SYNOPSIS
#include <security/pam_appl.h>

int pam_open_session(pam_handle_t *pamh, int flags);

DESCRIPTION

The pam_open_session function sets up a user session for a previously successful authenticated user. The session should later be terminated with a call to pam_close_session(3).

It should be noted that the effective uid, geteuid(2). of the application should be of sufficient privilege to perform such tasks as creating or mounting the user´s home directory for example.

The flags argument is the binary or of zero or more of the following values:

PAM_SILENT

Do not emit any messages.

RETURN VALUES
PAM_ABORT

General failure.

PAM_BUF_ERR

Memory buffer error.

PAM_SESSION_ERR

Session failure.

PAM_SUCCESS

Session was successful created.

SEE ALSO
pam_close_session(3), pam_strerror(3)

---