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