1.\" Generated from pam_open_session.c by gendoc.pl 2.\" $Id: pam_open_session.c 648 2013-03-05 17:54:27Z des $ 3.Dd February 19, 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_SYMBOL_ERR . 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_ABORT 41General failure. 42.It Bq Er PAM_BUF_ERR 43Memory buffer error. 44.It Bq Er PAM_CONV_ERR 45Conversation failure. 46.It Bq Er PAM_PERM_DENIED 47Permission denied. 48.It Bq Er PAM_SERVICE_ERR 49Error in service module. 50.It Bq Er PAM_SESSION_ERR 51Session failure. 52.It Bq Er PAM_SYMBOL_ERR 53Invalid symbol. 54.It Bq Er PAM_SYSTEM_ERR 55System error. 56.El 57.Sh SEE ALSO 58.Xr pam 3 , 59.Xr pam_close_session 3 , 60.Xr pam_strerror 3 61.Sh STANDARDS 62.Rs 63.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 64.%D "June 1997" 65.Re 66.Sh AUTHORS 67The 68.Fn pam_open_session 69function and this manual page were 70developed for the 71.Fx 72Project by ThinkSec AS and Network Associates Laboratories, the 73Security Research Division of Network Associates, Inc.\& under 74DARPA/SPAWAR contract N66001-01-C-8035 75.Pq Dq CBOSS , 76as part of the DARPA CHATS research program. 77.Pp 78The OpenPAM library is maintained by 79.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 80