pam_sm_open_session(3)                               pam_sm_open_session(3)




 NAME    [Toc]    [Back]
      pam_sm_open_session, pam_sm_close_session - Service provider
      implementation for pam_open_session and pam_close_session respectively

 SYNOPSIS    [Toc]    [Back]
      cc [ flag ... ] file ...  -lpam [ library ... ]

      #include <security/pam_appl.h>

      #include <security/pam_modules.h>

      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    [Toc]    [Back]
      In response to a call to pam_open_session() and pam_close_session(),
      the PAM framework calls pam_sm_open_session() and
      pam_sm_close_session(), respectively from the modules listed in the
      pam.conf(4) file.  The session management provider supplies the backend
 functionality for this interface function.

      pam_sm_open_session() is called to initiate session management.
      pam_sm_close_session() 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 messages.

      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 processed by the session management
      service. If an unknown option is passed in, an error should be logged
      through syslog(3C) and the option ignored.

 APPLICATION USAGE    [Toc]    [Back]
      Refer to pam(3) for information on thread-safety of PAM interfaces.

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

      PAM_SESSION_ERR        Can not make/remove an entry for the specified
                             session.

      PAM_IGNORE             Ignore underlying session module regardless of
                             whether the control flag is required, optional
                             or sufficient




 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 pam_sm_open_session(3)                               pam_sm_open_session(3)




 SEE ALSO    [Toc]    [Back]
      pam(3), pam_open_session(3), syslog(3C), pam.conf(4).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003