pam_get_data(3) — Linux manual page


PAM_GET_DATA(3)             Linux-PAM Manual             PAM_GET_DATA(3)

NAME         top

       pam_get_data - get module internal data

SYNOPSIS         top

       #include <security/pam_modules.h>

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

DESCRIPTION         top

       This function together with the pam_set_data(3) function is
       useful to manage module-specific data meaningful only to the
       calling PAM module.

       The pam_get_data function looks up the object associated with the
       (hopefully) unique string module_data_name in the PAM context
       specified by the pamh argument. A successful call to pam_get_data
       will result in data pointing to the object. Note, this data is
       not a copy and should be treated as constant by the module.

RETURN VALUES         top

           Data was successful retrieved.

           A NULL pointer was submitted as PAM handle or the function
           was called by an application.

           Module data not found or there is an entry, but it has the
           value NULL.

SEE ALSO         top

       pam_end(3), pam_set_data(3), pam_strerror(3)

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication
       Modules for Linux) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug report
       for this manual page, see ⟨//⟩.  This page was
       obtained from the tarball Linux-PAM-1.3.0.tar.bz2 fetched from
       ⟨⟩ on 2021-08-27.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

Linux-PAM Manual               04/01/2016                PAM_GET_DATA(3)

Pages that refer to this page: pam(3)pam_end(3)pam_set_data(3)pam_start(3)