xref: /freebsd/contrib/openpam/doc/man/pam_get_data.3 (revision 3ba4c8c81a28de3e00ccf6d7f92c6f8e58bef456)
1ce77a8d6SDag-Erling Smørgrav.\" Generated from pam_get_data.c by gendoc.pl
2*3ba4c8c8SDag-Erling Smørgrav.Dd June 27, 2023
35c1eca55SDag-Erling Smørgrav.Dt PAM_GET_DATA 3
45c1eca55SDag-Erling Smørgrav.Os
55c1eca55SDag-Erling Smørgrav.Sh NAME
65c1eca55SDag-Erling Smørgrav.Nm pam_get_data
75c1eca55SDag-Erling Smørgrav.Nd get module information
85c1eca55SDag-Erling Smørgrav.Sh SYNOPSIS
9644f2b7cSDag-Erling Smørgrav.In sys/types.h
105c1eca55SDag-Erling Smørgrav.In security/pam_appl.h
11ca236e63SDag-Erling Smørgrav.Ft "int"
12fe980754SDag-Erling Smørgrav.Fn pam_get_data "const pam_handle_t *pamh" "const char *module_data_name" "const void **data"
135c1eca55SDag-Erling Smørgrav.Sh DESCRIPTION
145c1eca55SDag-Erling SmørgravThe
152f3ed619SDag-Erling Smørgrav.Fn pam_get_data
1646acc370SDag-Erling Smørgravfunction looks up the opaque object associated with
1746acc370SDag-Erling Smørgravthe string specified by the
18b33ab329SDag-Erling Smørgrav.Fa module_data_name
1946acc370SDag-Erling Smørgravargument, in the PAM
2046acc370SDag-Erling Smørgravcontext specified by the
21b33ab329SDag-Erling Smørgrav.Fa pamh
2246acc370SDag-Erling Smørgravargument.
2346acc370SDag-Erling SmørgravA pointer to the object is stored in the location pointed to by the
24b33ab329SDag-Erling Smørgrav.Fa data
2546acc370SDag-Erling Smørgravargument.
267f106882SDag-Erling SmørgravIf
272f3ed619SDag-Erling Smørgrav.Fn pam_get_data
287f106882SDag-Erling Smørgravfails, the
297f106882SDag-Erling Smørgrav.Fa data
307f106882SDag-Erling Smørgravargument is untouched.
3146acc370SDag-Erling Smørgrav.Pp
3246acc370SDag-Erling SmørgravThis function and its counterpart
3346acc370SDag-Erling Smørgrav.Xr pam_set_data 3
3446acc370SDag-Erling Smørgravare useful for managing
3546acc370SDag-Erling Smørgravdata that are meaningful only to a particular service module.
365c1eca55SDag-Erling Smørgrav.Sh RETURN VALUES
375c1eca55SDag-Erling SmørgravThe
382f3ed619SDag-Erling Smørgrav.Fn pam_get_data
395c1eca55SDag-Erling Smørgravfunction returns one of the following values:
4046acc370SDag-Erling Smørgrav.Bl -tag -width 18n
4149e56509SDag-Erling Smørgrav.It Bq Er PAM_SUCCESS
4249e56509SDag-Erling SmørgravSuccess.
4346acc370SDag-Erling Smørgrav.It Bq Er PAM_NO_MODULE_DATA
4446acc370SDag-Erling SmørgravModule data not found.
455c1eca55SDag-Erling Smørgrav.El
465c1eca55SDag-Erling Smørgrav.Sh SEE ALSO
4746acc370SDag-Erling Smørgrav.Xr pam 3 ,
4846acc370SDag-Erling Smørgrav.Xr pam_set_data 3 ,
4946acc370SDag-Erling Smørgrav.Xr pam_strerror 3
505c1eca55SDag-Erling Smørgrav.Sh STANDARDS
515c1eca55SDag-Erling Smørgrav.Rs
525c1eca55SDag-Erling Smørgrav.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
535c1eca55SDag-Erling Smørgrav.%D "June 1997"
545c1eca55SDag-Erling Smørgrav.Re
555c1eca55SDag-Erling Smørgrav.Sh AUTHORS
565c1eca55SDag-Erling SmørgravThe
572f3ed619SDag-Erling Smørgrav.Fn pam_get_data
582f3ed619SDag-Erling Smørgravfunction and this manual page were
592f3ed619SDag-Erling Smørgravdeveloped for the
60ca236e63SDag-Erling Smørgrav.Fx
612f3ed619SDag-Erling SmørgravProject by ThinkSec AS and Network Associates Laboratories, the
629bc006deSDag-Erling SmørgravSecurity Research Division of Network Associates, Inc.\& under
63ca236e63SDag-Erling SmørgravDARPA/SPAWAR contract N66001-01-C-8035
645c1eca55SDag-Erling Smørgrav.Pq Dq CBOSS ,
655c1eca55SDag-Erling Smørgravas part of the DARPA CHATS research program.
66ce77a8d6SDag-Erling Smørgrav.Pp
67ce77a8d6SDag-Erling SmørgravThe OpenPAM library is maintained by
68f3b0ac34SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
69