PAM Library Functions                   pamsmopensession(3PAM)



NAME
     pamsmopensession, pamsmclosesession - service provider
     implementation for pamopensession and pamclosesession

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



     int pamsmopensession(pamhandlet *pamh, int flags,
          int argc, const char **argv);


     int pamsmclosesession(pamhandlet *pamh, int flags,
          int argc, const char **argv);


DESCRIPTION
     In  response  to  a  call  to   pamopensession(3PAM)   and
     pamclosesession(3PAM),    the     PAM    framework   calls
     pamsmopensession()  and  pamsmclosesession(),  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 pamsmopensession() function  is  called  to  initiate
     session  management.  Thepamsmclosesession()  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:

     PAMSILENT    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,  PAMSUCES should be returned.
     The following values may also be returned upon error:

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



SunOS 5.11          Last change: 13 Oct 1998                    1






PAM Library Functions                   pamsmopensession(3PAM)



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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability           Stable                     
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     pam(3PAM), pamopensession(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