1.\" Generated from pam_open_session.c by gendoc.pl 2.\" $OpenPAM: pam_open_session.c 938 2017-04-30 21:34:42Z des $ 3.Dd April 30, 2017 4.Dt PAM_OPEN_SESSION 3 5.Os 6.Sh NAME 7.Nm pam_open_session 8.Nd open a user session 9.Sh SYNOPSIS 10.In sys/types.h 11.In security/pam_appl.h 12.Ft "int" 13.Fn pam_open_session "pam_handle_t *pamh" "int flags" 14.Sh DESCRIPTION 15The 16.Fn pam_open_session 17sets up a user session for a previously 18authenticated user. 19The session should later be torn down by a call to 20.Xr pam_close_session 3 . 21.Pp 22The 23.Fa flags 24argument is the binary or of zero or more of the following 25values: 26.Bl -tag -width 18n 27.It Dv PAM_SILENT 28Do not emit any messages. 29.El 30.Pp 31If any other bits are set, 32.Fn pam_open_session 33will return 34.Dv PAM_BAD_CONSTANT . 35.Sh RETURN VALUES 36The 37.Fn pam_open_session 38function returns one of the following values: 39.Bl -tag -width 18n 40.It Bq Er PAM_SUCCESS 41Success. 42.It Bq Er PAM_ABORT 43General failure. 44.It Bq Er PAM_BAD_CONSTANT 45Bad constant. 46.It Bq Er PAM_BUF_ERR 47Memory buffer error. 48.It Bq Er PAM_CONV_ERR 49Conversation failure. 50.It Bq Er PAM_PERM_DENIED 51Permission denied. 52.It Bq Er PAM_SERVICE_ERR 53Error in service module. 54.It Bq Er PAM_SESSION_ERR 55Session failure. 56.It Bq Er PAM_SYSTEM_ERR 57System error. 58.El 59.Sh SEE ALSO 60.Xr pam 3 , 61.Xr pam_close_session 3 , 62.Xr pam_strerror 3 63.Sh STANDARDS 64.Rs 65.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 66.%D "June 1997" 67.Re 68.Sh AUTHORS 69The 70.Fn pam_open_session 71function and this manual page were 72developed for the 73.Fx 74Project by ThinkSec AS and Network Associates Laboratories, the 75Security Research Division of Network Associates, Inc.\& under 76DARPA/SPAWAR contract N66001-01-C-8035 77.Pq Dq CBOSS , 78as part of the DARPA CHATS research program. 79.Pp 80The OpenPAM library is maintained by 81.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 82