Manual Pages for UNIX Operating System command usage for man pam_sm_close_session

PAM Library Functions                   pam_sm_open_session(3PAM)



NAME
     pam_sm_open_session, pam_sm_close_session - service provider
     implementation for pam_open_session and pam_close_session

SYNOPSIS
     cc [ flag ... ]  file ... -lpam [ library ... ]
     #include 
     #include 

     int pam_sm_open_session(pam_handle_t *pamh, int flags,
          int argc, const char **argv);


     int pam_sm_close_session(pam_handle_t *pamh, int flags,
          int argc, const char **argv);


DESCRIPTION
     In  response  to  a  call  to   pam_open_session(3PAM)   and
     pam_close_session(3PAM),    the     PAM    framework   calls
     pam_sm_open_session()  and  pam_sm_close_session(),  respec-
     tively from the modules listed in the pam.conf(4) file.  The
     session management  provider  supplies  the  back-end  func-
     tionality for this interface function.


     The pam_sm_open_session() function  is  called  to  initiate
     session  management.  Thepam_sm_close_session()  function is
     invoked when a session has terminated. The argument pamh  is
     an  authentication  handle. The following flag may be set in
     the flags field:

     PAM_SILENT    Session service should not generate  any  mes-
                   sages.



     The argc argument represents the number  of  module  options
     passed  in  from  the  configuration  file pam.conf(4). argv
     specifies the module options, which are interpreted and pro-
     cessed  by  the  session  management  service. If an unknown
     option is passed in,  an  error  should  be  logged  through
     syslog(3C) and the option ignored.

RETURN VALUES
     Upon successful completion,  PAM_SUCCESS should be returned.
     The following values may also be returned upon error:

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





SunOS 5.11          Last change: 13 Oct 1998                    1






PAM Library Functions                   pam_sm_open_session(3PAM)



     PAM_IGNORE         Ignore underlying session module  regard-
                        less  of  whether  the  control   flag is
                        required, optional or sufficient.


ATTRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|


SEE ALSO
     pam(3PAM), pam_open_session(3PAM), syslog(3C), libpam(3LIB),
     pam.conf(4), attributes(5)

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



























SunOS 5.11          Last change: 13 Oct 1998                    2