$Id: pam_open_session.c 648 2013-03-05 17:54:27Z des $
.Dd September 7, 2013 .Dt PAM_OPEN_SESSION 3 .Os .Sh NAME .Nm pam_open_session .Nd open a user session .Sh LIBRARY .Lb libpam .Sh SYNOPSIS n sys/types.h n security/pam_appl.h .Ft "int" .Fn pam_open_session "pam_handle_t *pamh" "int flags" .Sh DESCRIPTION The .Fn pam_open_session sets up a user session for a previously authenticated user. The session should later be torn down by a call to .Xr pam_close_session 3 .
p The .Fa flags argument is the binary or of zero or more of the following values: l -tag -width 18n t Dv PAM_SILENT Do not emit any messages. .El
p If any other bits are set, .Fn pam_open_session will return .Dv PAM_SYMBOL_ERR . .Sh RETURN VALUES The .Fn pam_open_session function returns one of the following values: l -tag -width 18n t Bq Er PAM_ABORT General failure. t Bq Er PAM_BUF_ERR Memory buffer error. t Bq Er PAM_CONV_ERR Conversation failure. t Bq Er PAM_PERM_DENIED Permission denied. t Bq Er PAM_SERVICE_ERR Error in service module. t Bq Er PAM_SESSION_ERR Session failure. t Bq Er PAM_SYMBOL_ERR Invalid symbol. t Bq Er PAM_SYSTEM_ERR System error. .El .Sh SEE ALSO .Xr pam 3 , .Xr pam_close_session 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_open_session 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 .