PAM_OPEN_SESSION(3)

  .SH "NAME" pam_open_session - start PAM session management
  .SH "SYNOPSIS"

#include <security/pam_appl.h>

      .HP u int pam_open_session(pam_handle_t *pamh, int flags);

  .SH "DESCRIPTION"

    .PP 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).
    .PP 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.
    .PP The flags argument is the binary or of zero or more of the following values:

      .PP PAM_SILENT

               Do not emit any messages.

          .RE

      .SH "RETURN VALUES"

          .PP PAM_ABORT

                   General failure.

              .RE
              .PP PAM_BUF_ERR

                       Memory buffer error.

                  .RE
                  .PP PAM_SESSION_ERR

                           Session failure.

                      .RE
                      .PP PAM_SUCCESS

                               Session was successful created.

                          .RE

                      .SH "SEE ALSO"

                        .PP pam_close_session(3), pam_strerror(3)