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