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

개요

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

pam_get_data(3pam)

pam_set_data(3PAM)           PAM Library Functions          pam_set_data(3PAM)



NAME
       pam_set_data,  pam_get_data  - PAM routines to maintain module specific
       state

SYNOPSIS
       cc [ flag ... ] file ... -lpam [ library ... ]
       #include <security/pam_appl.h>

       int pam_set_data(pam_handle_t *pamh,
            const char *module_data_name, void *data,
            void (*cleanup) (pam_handle_t *pamh, void *data,
            int pam_end_status));


       int pam_get_data(const pam_handle_t *pamh,
            const char *module_data_name, const void **data);

DESCRIPTION
       The pam_set_data() and pam_get_data() functions allow PAM service  mod‐
       ules  to access and update module specific information as needed. These
       functions should not be used by applications.


       The pam_set_data() function stores module specific data within the  PAM
       handle  pamh.  The  module_data_name  argument  uniquely identifies the
       data, and the data  argument  represents  the  actual  data.  The  mod‐
       ule_data_name argument should be unique across all services.


       The  pam_set_data()  function  may  register  a  cleanup function to be
       called during pam_end(3PAM) processing. The cleanup function should  do
       whatever  is  appropriate based on pam_end_status, the status passed to
       pam_end() by  the  application.  Any  allocated  memory  for  the  mod‐
       ule_data_name must be freed.


       If pam_set_data() is called and module data already exists from a prior
       call to pam_set_data() under the same  module_data_name,  the  existing
       cleanup  function  is  called with a pam_end_status of PAM_SUCCESS, the
       existing data is replaced by the new data,  and  the  existing  cleanup
       function is replaced by the new cleanup function.


       The  pam_get_data()  function  retrieves module-specific data stored in
       the PAM handle, pamh, identified by the unique name,  module_data_name.
       The  data  argument  is assigned the address of the requested data. The
       data retrieved by pam_get_data() should not be modified or  freed.  The
       data will be released by pam_end().

RETURN VALUES
       In  addition  to  the  return values listed in pam(3PAM), the following
       value may also be returned:

       PAM_NO_MODULE_DATA    No module specific data is present.


ATTRIBUTES
       See attributes(7) for description 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
       exceptions


SEE ALSO
       libpam(3LIB), pam(3PAM), pam_end(3PAM), attributes(7)

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



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