PAMGETDATA(3) Linux-PAM Manual PAMGETDATA(3)

NAME
       pamgetdata - get module internal data

SYNOPSIS
       ##iinncclluuddee <>

       iinntt ppaammggeettddaattaa((ccoonnsstt ppaammhhaannddlleett **pamh,,
                        ccoonnsstt cchhaarr **moduledataname,, ccoonnsstt vvooiidd ****data));;

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

       The ppaammggeettddaattaa function looks up the object associated with the
       (hopefully) unique string moduledataname in the PAM context specified
       by the pamh argument. A successful call to ppaammggeettddaattaa 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
       PAMSUCCESS
          Data was successful retrieved.

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

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

SEE ALSO
       ppaammeenndd(3), ppaammsseettddaattaa(3), ppaammssttrreerrrroorr(3)



Linux-PAM Manual                  06/27/2006                   PAMGETDATA(3)