1.\" Generated from pam_set_data.c by gendoc.pl 2.\" $Id: pam_set_data.c 913 2017-01-21 15:11:12Z des $ 3.Dd February 19, 2017 4.Dt PAM_SET_DATA 3 5.Os 6.Sh NAME 7.Nm pam_set_data 8.Nd set module information 9.Sh SYNOPSIS 10.In sys/types.h 11.In security/pam_appl.h 12.Ft "int" 13.Fn 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)" 14.Sh DESCRIPTION 15The 16.Fn pam_set_data 17function associates a pointer to an opaque object 18with an arbitrary string specified by the 19.Fa module_data_name 20argument, 21in the PAM context specified by the 22.Fa pamh 23argument. 24.Pp 25If not 26.Dv NULL , 27the 28.Fa cleanup 29argument should point to a function 30responsible for releasing the resources associated with the object. 31.Pp 32This function and its counterpart 33.Xr pam_get_data 3 34are useful for managing 35data that are meaningful only to a particular service module. 36.Sh RETURN VALUES 37The 38.Fn pam_set_data 39function returns one of the following values: 40.Bl -tag -width 18n 41.It Bq Er PAM_BUF_ERR 42Memory buffer error. 43.It Bq Er PAM_SYSTEM_ERR 44System error. 45.El 46.Sh SEE ALSO 47.Xr pam 3 , 48.Xr pam_get_data 3 , 49.Xr pam_strerror 3 50.Sh STANDARDS 51.Rs 52.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 53.%D "June 1997" 54.Re 55.Sh AUTHORS 56The 57.Fn pam_set_data 58function and this manual page were 59developed for the 60.Fx 61Project by ThinkSec AS and Network Associates Laboratories, the 62Security Research Division of Network Associates, Inc.\& under 63DARPA/SPAWAR contract N66001-01-C-8035 64.Pq Dq CBOSS , 65as part of the DARPA CHATS research program. 66.Pp 67The OpenPAM library is maintained by 68.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 69