1.\" $NetBSD: pam_get_data.3,v 1.8 2019/12/15 17:08:21 christos Exp $ 2.\" 3.\" Generated from pam_get_data.c by gendoc.pl 4.\" $OpenPAM: pam_get_data.c 938 2017-04-30 21:34:42Z des $ 5.Dd February 24, 2019 6.Dt PAM_GET_DATA 3 7.Os 8.Sh NAME 9.Nm pam_get_data 10.Nd get module information 11.Sh SYNOPSIS 12.In sys/types.h 13.In security/pam_appl.h 14.Ft "int" 15.Fn pam_get_data "const pam_handle_t *pamh" "const char *module_data_name" "const void **data" 16.Sh DESCRIPTION 17The 18.Fn pam_get_data 19function looks up the opaque object associated with 20the string specified by the 21.Fa module_data_name 22argument, in the PAM 23context specified by the 24.Fa pamh 25argument. 26A pointer to the object is stored in the location pointed to by the 27.Fa data 28argument. 29If 30.Fn pam_get_data 31fails, the 32.Fa data 33argument is untouched. 34.Pp 35This function and its counterpart 36.Xr pam_set_data 3 37are useful for managing 38data that are meaningful only to a particular service module. 39.Sh RETURN VALUES 40The 41.Fn pam_get_data 42function returns one of the following values: 43.Bl -tag -width 18n 44.It Bq Er PAM_SUCCESS 45Success. 46.It Bq Er PAM_NO_MODULE_DATA 47Module data not found. 48.El 49.Sh SEE ALSO 50.Xr pam 3 , 51.Xr pam_set_data 3 , 52.Xr pam_strerror 3 53.Sh STANDARDS 54.Rs 55.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 56.%D "June 1997" 57.Re 58.Sh AUTHORS 59The 60.Fn pam_get_data 61function and this manual page were 62developed for the 63.Fx 64Project by ThinkSec AS and Network Associates Laboratories, the 65Security Research Division of Network Associates, Inc.\& under 66DARPA/SPAWAR contract N66001-01-C-8035 67.Pq Dq CBOSS , 68as part of the DARPA CHATS research program. 69.Pp 70The OpenPAM library is maintained by 71.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 72