1*ade90846SJoerg Sonnenberger.\"- 2*ade90846SJoerg Sonnenberger.\" Copyright (c) 2001-2003 Networks Associates Technology, Inc. 3*ade90846SJoerg Sonnenberger.\" All rights reserved. 4*ade90846SJoerg Sonnenberger.\" 5*ade90846SJoerg Sonnenberger.\" This software was developed for the FreeBSD Project by ThinkSec AS and 6*ade90846SJoerg Sonnenberger.\" Network Associates Laboratories, the Security Research Division of 7*ade90846SJoerg Sonnenberger.\" Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 8*ade90846SJoerg Sonnenberger.\" ("CBOSS"), as part of the DARPA CHATS research program. 9*ade90846SJoerg Sonnenberger.\" 10*ade90846SJoerg Sonnenberger.\" Redistribution and use in source and binary forms, with or without 11*ade90846SJoerg Sonnenberger.\" modification, are permitted provided that the following conditions 12*ade90846SJoerg Sonnenberger.\" are met: 13*ade90846SJoerg Sonnenberger.\" 1. Redistributions of source code must retain the above copyright 14*ade90846SJoerg Sonnenberger.\" notice, this list of conditions and the following disclaimer. 15*ade90846SJoerg Sonnenberger.\" 2. Redistributions in binary form must reproduce the above copyright 16*ade90846SJoerg Sonnenberger.\" notice, this list of conditions and the following disclaimer in the 17*ade90846SJoerg Sonnenberger.\" documentation and/or other materials provided with the distribution. 18*ade90846SJoerg Sonnenberger.\" 3. The name of the author may not be used to endorse or promote 19*ade90846SJoerg Sonnenberger.\" products derived from this software without specific prior written 20*ade90846SJoerg Sonnenberger.\" permission. 21*ade90846SJoerg Sonnenberger.\" 22*ade90846SJoerg Sonnenberger.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 23*ade90846SJoerg Sonnenberger.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24*ade90846SJoerg Sonnenberger.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25*ade90846SJoerg Sonnenberger.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 26*ade90846SJoerg Sonnenberger.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27*ade90846SJoerg Sonnenberger.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28*ade90846SJoerg Sonnenberger.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29*ade90846SJoerg Sonnenberger.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30*ade90846SJoerg Sonnenberger.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31*ade90846SJoerg Sonnenberger.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32*ade90846SJoerg Sonnenberger.\" SUCH DAMAGE. 33*ade90846SJoerg Sonnenberger.\" 34*ade90846SJoerg Sonnenberger.\" $P4$ 35*ade90846SJoerg Sonnenberger.\" 36*ade90846SJoerg Sonnenberger.Dd June 16, 2005 37*ade90846SJoerg Sonnenberger.Dt PAM_GET_DATA 3 38*ade90846SJoerg Sonnenberger.Os 39*ade90846SJoerg Sonnenberger.Sh NAME 40*ade90846SJoerg Sonnenberger.Nm pam_get_data 41*ade90846SJoerg Sonnenberger.Nd get module information 42*ade90846SJoerg Sonnenberger.Sh LIBRARY 43*ade90846SJoerg Sonnenberger.Lb libpam 44*ade90846SJoerg Sonnenberger.Sh SYNOPSIS 45*ade90846SJoerg Sonnenberger.In sys/types.h 46*ade90846SJoerg Sonnenberger.In security/pam_appl.h 47*ade90846SJoerg Sonnenberger.Ft "int" 48*ade90846SJoerg Sonnenberger.Fn pam_get_data "pam_handle_t *pamh" "const char *module_data_name" "void **data" 49*ade90846SJoerg Sonnenberger.Sh DESCRIPTION 50*ade90846SJoerg SonnenbergerThe 51*ade90846SJoerg Sonnenberger.Nm 52*ade90846SJoerg Sonnenbergerfunction looks up the opaque object associated with 53*ade90846SJoerg Sonnenbergerthe string specified by the 54*ade90846SJoerg Sonnenberger.Fa module_data_name 55*ade90846SJoerg Sonnenbergerargument, in the PAM 56*ade90846SJoerg Sonnenbergercontext specified by the 57*ade90846SJoerg Sonnenberger.Fa pamh 58*ade90846SJoerg Sonnenbergerargument. 59*ade90846SJoerg SonnenbergerA pointer to the object is stored in the location pointed to by the 60*ade90846SJoerg Sonnenberger.Fa data 61*ade90846SJoerg Sonnenbergerargument. 62*ade90846SJoerg Sonnenberger.Pp 63*ade90846SJoerg SonnenbergerThis function and its counterpart 64*ade90846SJoerg Sonnenberger.Xr pam_set_data 3 65*ade90846SJoerg Sonnenbergerare useful for managing 66*ade90846SJoerg Sonnenbergerdata that are meaningful only to a particular service module. 67*ade90846SJoerg Sonnenberger.Sh RETURN VALUES 68*ade90846SJoerg SonnenbergerThe 69*ade90846SJoerg Sonnenberger.Nm 70*ade90846SJoerg Sonnenbergerfunction returns one of the following values: 71*ade90846SJoerg Sonnenberger.Bl -tag -width 18n 72*ade90846SJoerg Sonnenberger.It Bq Er PAM_NO_MODULE_DATA 73*ade90846SJoerg SonnenbergerModule data not found. 74*ade90846SJoerg Sonnenberger.It Bq Er PAM_SYSTEM_ERR 75*ade90846SJoerg SonnenbergerSystem error. 76*ade90846SJoerg Sonnenberger.El 77*ade90846SJoerg Sonnenberger.Sh SEE ALSO 78*ade90846SJoerg Sonnenberger.Xr pam 3 , 79*ade90846SJoerg Sonnenberger.Xr pam_set_data 3 , 80*ade90846SJoerg Sonnenberger.Xr pam_strerror 3 81*ade90846SJoerg Sonnenberger.Sh STANDARDS 82*ade90846SJoerg Sonnenberger.Rs 83*ade90846SJoerg Sonnenberger.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 84*ade90846SJoerg Sonnenberger.%D "June 1997" 85*ade90846SJoerg Sonnenberger.Re 86*ade90846SJoerg Sonnenberger.Sh AUTHORS 87*ade90846SJoerg SonnenbergerThe 88*ade90846SJoerg Sonnenberger.Nm 89*ade90846SJoerg Sonnenbergerfunction and this manual page were developed for the 90*ade90846SJoerg Sonnenberger.Fx 91*ade90846SJoerg SonnenbergerProject by ThinkSec AS and Network Associates Laboratories, the 92*ade90846SJoerg SonnenbergerSecurity Research Division of Network Associates, Inc.& under 93*ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035 94*ade90846SJoerg Sonnenberger.Pq Dq CBOSS , 95*ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program. 96