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