$Id: pam_start.c 648 2013-03-05 17:54:27Z des $
.Dd September 12, 2014 .Dt PAM_START 3 .Os .Sh NAME .Nm pam_start .Nd initiate a PAM transaction .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h .Ft "int" .Fn pam_start "const char *service" "const char *user" "const struct pam_conv *pam_conv" "pam_handle_t **pamh" .Sh DESCRIPTION The .Fn pam_start function creates and initializes a PAM context.
p The .Fa service argument specifies the name of the policy to apply, and is stored in the .Dv PAM_SERVICE item in the created context.
p The .Fa user argument specifies the name of the target user - the user the created context will serve to authenticate. It is stored in the .Dv PAM_USER item in the created context.
p The .Fa pam_conv argument points to a .Vt struct pam_conv describing the conversation function to use; see .Fa pam_conv for details.
p .Sh RETURN VALUES The .Fn pam_start function returns one of the following values: l -tag -width 18n t Bq Er PAM_BUF_ERR Memory buffer error. t Bq Er PAM_SYSTEM_ERR System error. .El .Sh SEE ALSO .Xr pam 3 , .Xr pam_end 3 , .Xr pam_get_item 3 , .Xr pam_set_item 3 , .Xr pam_strerror 3 .Sh STANDARDS .Rs .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" .%D "June 1997" .Re .Sh AUTHORS The .Fn pam_start function and this manual page were developed for the .Fx Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
q Dq CBOSS , as part of the DARPA CHATS research program.
p The OpenPAM library is maintained by .An Dag-Erling Sm\(/orgrav Aq des@des.no .