xref: /freebsd/contrib/openpam/doc/man/pam_get_data.3 (revision 49e56509dbc8fd972cf527b2966bf56ce9c0726e)
1ce77a8d6SDag-Erling Smørgrav.\" Generated from pam_get_data.c by gendoc.pl
2*49e56509SDag-Erling Smørgrav.\" $OpenPAM: pam_get_data.c 938 2017-04-30 21:34:42Z des $
3*49e56509SDag-Erling Smørgrav.Dd April 30, 2017
45c1eca55SDag-Erling Smørgrav.Dt PAM_GET_DATA 3
55c1eca55SDag-Erling Smørgrav.Os
65c1eca55SDag-Erling Smørgrav.Sh NAME
75c1eca55SDag-Erling Smørgrav.Nm pam_get_data
85c1eca55SDag-Erling Smørgrav.Nd get module information
95c1eca55SDag-Erling Smørgrav.Sh SYNOPSIS
10644f2b7cSDag-Erling Smørgrav.In sys/types.h
115c1eca55SDag-Erling Smørgrav.In security/pam_appl.h
12ca236e63SDag-Erling Smørgrav.Ft "int"
13fe980754SDag-Erling Smørgrav.Fn pam_get_data "const pam_handle_t *pamh" "const char *module_data_name" "const void **data"
145c1eca55SDag-Erling Smørgrav.Sh DESCRIPTION
155c1eca55SDag-Erling SmørgravThe
162f3ed619SDag-Erling Smørgrav.Fn pam_get_data
1746acc370SDag-Erling Smørgravfunction looks up the opaque object associated with
1846acc370SDag-Erling Smørgravthe string specified by the
19b33ab329SDag-Erling Smørgrav.Fa module_data_name
2046acc370SDag-Erling Smørgravargument, in the PAM
2146acc370SDag-Erling Smørgravcontext specified by the
22b33ab329SDag-Erling Smørgrav.Fa pamh
2346acc370SDag-Erling Smørgravargument.
2446acc370SDag-Erling SmørgravA pointer to the object is stored in the location pointed to by the
25b33ab329SDag-Erling Smørgrav.Fa data
2646acc370SDag-Erling Smørgravargument.
277f106882SDag-Erling SmørgravIf
282f3ed619SDag-Erling Smørgrav.Fn pam_get_data
297f106882SDag-Erling Smørgravfails, the
307f106882SDag-Erling Smørgrav.Fa data
317f106882SDag-Erling Smørgravargument is untouched.
3246acc370SDag-Erling Smørgrav.Pp
3346acc370SDag-Erling SmørgravThis function and its counterpart
3446acc370SDag-Erling Smørgrav.Xr pam_set_data 3
3546acc370SDag-Erling Smørgravare useful for managing
3646acc370SDag-Erling Smørgravdata that are meaningful only to a particular service module.
375c1eca55SDag-Erling Smørgrav.Sh RETURN VALUES
385c1eca55SDag-Erling SmørgravThe
392f3ed619SDag-Erling Smørgrav.Fn pam_get_data
405c1eca55SDag-Erling Smørgravfunction returns one of the following values:
4146acc370SDag-Erling Smørgrav.Bl -tag -width 18n
42*49e56509SDag-Erling Smørgrav.It Bq Er PAM_SUCCESS
43*49e56509SDag-Erling SmørgravSuccess.
4446acc370SDag-Erling Smørgrav.It Bq Er PAM_NO_MODULE_DATA
4546acc370SDag-Erling SmørgravModule data not found.
465c1eca55SDag-Erling Smørgrav.El
475c1eca55SDag-Erling Smørgrav.Sh SEE ALSO
4846acc370SDag-Erling Smørgrav.Xr pam 3 ,
4946acc370SDag-Erling Smørgrav.Xr pam_set_data 3 ,
5046acc370SDag-Erling Smørgrav.Xr pam_strerror 3
515c1eca55SDag-Erling Smørgrav.Sh STANDARDS
525c1eca55SDag-Erling Smørgrav.Rs
535c1eca55SDag-Erling Smørgrav.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
545c1eca55SDag-Erling Smørgrav.%D "June 1997"
555c1eca55SDag-Erling Smørgrav.Re
565c1eca55SDag-Erling Smørgrav.Sh AUTHORS
575c1eca55SDag-Erling SmørgravThe
582f3ed619SDag-Erling Smørgrav.Fn pam_get_data
592f3ed619SDag-Erling Smørgravfunction and this manual page were
602f3ed619SDag-Erling Smørgravdeveloped for the
61ca236e63SDag-Erling Smørgrav.Fx
622f3ed619SDag-Erling SmørgravProject by ThinkSec AS and Network Associates Laboratories, the
639bc006deSDag-Erling SmørgravSecurity Research Division of Network Associates, Inc.\& under
64ca236e63SDag-Erling SmørgravDARPA/SPAWAR contract N66001-01-C-8035
655c1eca55SDag-Erling Smørgrav.Pq Dq CBOSS ,
665c1eca55SDag-Erling Smørgravas part of the DARPA CHATS research program.
67ce77a8d6SDag-Erling Smørgrav.Pp
68ce77a8d6SDag-Erling SmørgravThe OpenPAM library is maintained by
69f3b0ac34SDag-Erling Smørgrav.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
70