Man Linux: Main Page and Category List

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)