pam_close_session(3pam) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pam_close_session(3pam)

pam_open_session(3PAM)       PAM Library Functions      pam_open_session(3PAM)

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
       The pam_open_session() function is called after a user  has  been  suc‐
       cessfully     authenticated.     See     pam_authenticate(3PAM)     and
       pam_acct_mgmt(3PAM). It is used to notify the session  modules  that  a
       new session has been initiated. All programs that use the pam(3PAM) li‐
       brary  should  invoke  pam_open_session() when beginning a new session.
       Upon termination of this activity, pam_close_session()  should  be  in‐
       voked to inform pam(3PAM) 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.


RETURN VALUES
       Upon successful completion, PAM_SUCCESS is returned. In addition to the
       return values defined in pam(3PAM), the following value may be returned
       on error:

       PAM_SESSION_ERR    Cannot  make  or  remove  an entry for the specified
                          session.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelMT-Safe with ex‐
       ceptions



       The  interfaces  in  libpam  are MT-Safe only if each thread within the
       multithreaded application uses its own PAM handle.

SEE ALSO
       getutxent(3C), pam(3PAM), pam_acct_mgmt(3PAM),  pam_authenticate(3PAM),
       pam_start(3PAM), attributes(7), pam_unix_session(7)

NOTES
       In many instances, the pam_open_session() and pam_close_session() calls
       may be made by different processes. For example, for console logins the
       login  process  opens a session, while the init process closes the ses‐
       sion. In this case, 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 combi‐
       nation 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.

HISTORY
       The  pam_open_session()  and  pam_close_session() functions were intro‐
       duced in Solaris 2.6.

Oracle Solaris 11.4               15 Mar 2023           pam_open_session(3PAM)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3