xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_end.3 (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1.\"	$NetBSD: pam_end.3,v 1.4 2013/12/27 20:10:20 christos Exp $
2.\"
3.\" Generated from pam_end.c by gendoc.pl
4.\" Id: pam_end.c 648 2013-03-05 17:54:27Z des
5.Dd September 7, 2013
6.Dt PAM_END 3
7.Os
8.Sh NAME
9.Nm pam_end
10.Nd terminate the PAM transaction
11.Sh LIBRARY
12.Lb libpam
13.Sh SYNOPSIS
14.In sys/types.h
15.In security/pam_appl.h
16.Ft "int"
17.Fn pam_end "pam_handle_t *pamh" "int status"
18.Sh DESCRIPTION
19The
20.Fn pam_end
21function terminates a PAM transaction and destroys the
22corresponding PAM context, releasing all resources allocated to it.
23.Pp
24The
25.Fa status
26argument should be set to the error code returned by the
27last API call before the call to
28.Fn pam_end .
29.Sh RETURN VALUES
30The
31.Fn pam_end
32function returns one of the following values:
33.Bl -tag -width 18n
34.It Bq Er PAM_SYSTEM_ERR
35System error.
36.El
37.Sh SEE ALSO
38.Xr pam 3 ,
39.Xr pam_strerror 3
40.Sh STANDARDS
41.Rs
42.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
43.%D "June 1997"
44.Re
45.Sh AUTHORS
46The
47.Fn pam_end
48function and this manual page were
49developed for the
50.Fx
51Project by ThinkSec AS and Network Associates Laboratories, the
52Security Research Division of Network Associates, Inc.\& under
53DARPA/SPAWAR contract N66001-01-C-8035
54.Pq Dq CBOSS ,
55as part of the DARPA CHATS research program.
56.Pp
57The OpenPAM library is maintained by
58.An Dag-Erling Sm\(/orgrav Aq des@des.no .
59