xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_end.3 (revision 53b02e147d4ed531c0d2a5ca9b3e8026ba3e99b5)
1.\"	$NetBSD: pam_end.3,v 1.8 2019/12/15 17:08:21 christos Exp $
2.\"
3.\" Generated from pam_end.c by gendoc.pl
4.\" $OpenPAM: pam_end.c 938 2017-04-30 21:34:42Z des $
5.Dd February 24, 2019
6.Dt PAM_END 3
7.Os
8.Sh NAME
9.Nm pam_end
10.Nd terminate the PAM transaction
11.Sh SYNOPSIS
12.In sys/types.h
13.In security/pam_appl.h
14.Ft "int"
15.Fn pam_end "pam_handle_t *pamh" "int status"
16.Sh DESCRIPTION
17The
18.Fn pam_end
19function terminates a PAM transaction and destroys the
20corresponding PAM context, releasing all resources allocated to it.
21.Pp
22The
23.Fa status
24argument should be set to the error code returned by the
25last API call before the call to
26.Fn pam_end .
27.Sh RETURN VALUES
28The
29.Fn pam_end
30function returns one of the following values:
31.Bl -tag -width 18n
32.It Bq Er PAM_SUCCESS
33Success.
34.It Bq Er PAM_BAD_HANDLE
35Invalid PAM handle.
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 Mt des@des.no .
59