PAM_SET_DATA - Online Linux Manual PageSection : 3
Updated : 09/03/2021
Source : Linux-PAM Manual
Note : Linux-PAM Manual

NAMEpam_set_data − set module internal data

SYNOPSIS#include <security/pam_modules​.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 error_status));

DESCRIPTIONThe pam_set_data function associates a pointer to an object with the (hopefully) unique string module_data_name in the PAM context specified by the pamh argument​. PAM modules may be dynamically loadable objects​. In general such files should not contain static variables​. This function and its counterpart pam_get_data(3), provide a mechanism for a module to associate some data with the handle pamh​. Typically a module will call the pam_set_data function to register some data under a (hopefully) unique module_data_name​. The data is available for use by other modules too but not by an application​. Since this functions stores only a pointer to the data, the module should not modify or free the content of it​. The function cleanup() is associated with the data and, if non−NULL, it is called when this data is over−written or following a call to pam_end(3)​. The error_status argument is used to indicate to the module the sort of action it is to take in cleaning this data item​. As an example, Kerberos creates a ticket file during the authentication phase, this file might be associated with a data item​. When pam_end(3) is called by the module, the error_status carries the return value of the pam_authenticate(3) or other libpam function as appropriate​. Based on this value the Kerberos module may choose to delete the ticket file (authentication failure) or leave it in place​. The error_status may have been logically OR'd with either of the following two values: PAM_DATA_REPLACE When a data item is being replaced (through a second call to pam_set_data) this mask is used​. Otherwise, the call is assumed to be from pam_end(3)​. PAM_DATA_SILENT Which indicates that the process would prefer to perform the cleanup() quietly​. That is, discourages logging/messages to the user​.

RETURN VALUESPAM_BUF_ERR Memory buffer error​. PAM_SUCCESS Data was successful stored​. PAM_SYSTEM_ERR A NULL pointer was submitted as PAM handle or the function was called by an application​.

SEE ALSOpam_end(3), pam_get_data(3), pam_strerror(3)
0
Johanes Gumabo
Data Size   :   9,818 byte
man-pam_set_data.3Build   :   2024-12-29, 07:25   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 259,040
Visitor ID   :     :  
Visitor IP   :   18.191.103.10   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.29
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.