xref: /dflybsd-src/contrib/openpam/doc/man/pam_end.3 (revision ade90846ffbb7aead93829eaba21d490f1a7bc6c)
1*ade90846SJoerg Sonnenberger.\"-
2*ade90846SJoerg Sonnenberger.\" Copyright (c) 2001-2003 Networks Associates Technology, Inc.
3*ade90846SJoerg Sonnenberger.\" All rights reserved.
4*ade90846SJoerg Sonnenberger.\"
5*ade90846SJoerg Sonnenberger.\" This software was developed for the FreeBSD Project by ThinkSec AS and
6*ade90846SJoerg Sonnenberger.\" Network Associates Laboratories, the Security Research Division of
7*ade90846SJoerg Sonnenberger.\" Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
8*ade90846SJoerg Sonnenberger.\" ("CBOSS"), as part of the DARPA CHATS research program.
9*ade90846SJoerg Sonnenberger.\"
10*ade90846SJoerg Sonnenberger.\" Redistribution and use in source and binary forms, with or without
11*ade90846SJoerg Sonnenberger.\" modification, are permitted provided that the following conditions
12*ade90846SJoerg Sonnenberger.\" are met:
13*ade90846SJoerg Sonnenberger.\" 1. Redistributions of source code must retain the above copyright
14*ade90846SJoerg Sonnenberger.\"    notice, this list of conditions and the following disclaimer.
15*ade90846SJoerg Sonnenberger.\" 2. Redistributions in binary form must reproduce the above copyright
16*ade90846SJoerg Sonnenberger.\"    notice, this list of conditions and the following disclaimer in the
17*ade90846SJoerg Sonnenberger.\"    documentation and/or other materials provided with the distribution.
18*ade90846SJoerg Sonnenberger.\" 3. The name of the author may not be used to endorse or promote
19*ade90846SJoerg Sonnenberger.\"    products derived from this software without specific prior written
20*ade90846SJoerg Sonnenberger.\"    permission.
21*ade90846SJoerg Sonnenberger.\"
22*ade90846SJoerg Sonnenberger.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
23*ade90846SJoerg Sonnenberger.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24*ade90846SJoerg Sonnenberger.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25*ade90846SJoerg Sonnenberger.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
26*ade90846SJoerg Sonnenberger.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27*ade90846SJoerg Sonnenberger.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28*ade90846SJoerg Sonnenberger.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29*ade90846SJoerg Sonnenberger.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30*ade90846SJoerg Sonnenberger.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31*ade90846SJoerg Sonnenberger.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32*ade90846SJoerg Sonnenberger.\" SUCH DAMAGE.
33*ade90846SJoerg Sonnenberger.\"
34*ade90846SJoerg Sonnenberger.\" $P4$
35*ade90846SJoerg Sonnenberger.\"
36*ade90846SJoerg Sonnenberger.Dd June 16, 2005
37*ade90846SJoerg Sonnenberger.Dt PAM_END 3
38*ade90846SJoerg Sonnenberger.Os
39*ade90846SJoerg Sonnenberger.Sh NAME
40*ade90846SJoerg Sonnenberger.Nm pam_end
41*ade90846SJoerg Sonnenberger.Nd terminate the PAM transaction
42*ade90846SJoerg Sonnenberger.Sh LIBRARY
43*ade90846SJoerg Sonnenberger.Lb libpam
44*ade90846SJoerg Sonnenberger.Sh SYNOPSIS
45*ade90846SJoerg Sonnenberger.In sys/types.h
46*ade90846SJoerg Sonnenberger.In security/pam_appl.h
47*ade90846SJoerg Sonnenberger.Ft "int"
48*ade90846SJoerg Sonnenberger.Fn pam_end "pam_handle_t *pamh" "int status"
49*ade90846SJoerg Sonnenberger.Sh DESCRIPTION
50*ade90846SJoerg SonnenbergerThe
51*ade90846SJoerg Sonnenberger.Nm
52*ade90846SJoerg Sonnenbergerfunction terminates a PAM transaction and destroys the
53*ade90846SJoerg Sonnenbergercorresponding PAM context, releasing all resources allocated to it.
54*ade90846SJoerg Sonnenberger.Pp
55*ade90846SJoerg SonnenbergerThe
56*ade90846SJoerg Sonnenberger.Fa status
57*ade90846SJoerg Sonnenbergerargument should be set to the error code returned by the
58*ade90846SJoerg Sonnenbergerlast API call before the call to
59*ade90846SJoerg Sonnenberger.Nm
60*ade90846SJoerg Sonnenberger.
61*ade90846SJoerg Sonnenberger.Sh RETURN VALUES
62*ade90846SJoerg SonnenbergerThe
63*ade90846SJoerg Sonnenberger.Nm
64*ade90846SJoerg Sonnenbergerfunction returns one of the following values:
65*ade90846SJoerg Sonnenberger.Bl -tag -width 18n
66*ade90846SJoerg Sonnenberger.It Bq Er PAM_SYSTEM_ERR
67*ade90846SJoerg SonnenbergerSystem error.
68*ade90846SJoerg Sonnenberger.El
69*ade90846SJoerg Sonnenberger.Sh SEE ALSO
70*ade90846SJoerg Sonnenberger.Xr pam 3 ,
71*ade90846SJoerg Sonnenberger.Xr pam_strerror 3
72*ade90846SJoerg Sonnenberger.Sh STANDARDS
73*ade90846SJoerg Sonnenberger.Rs
74*ade90846SJoerg Sonnenberger.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
75*ade90846SJoerg Sonnenberger.%D "June 1997"
76*ade90846SJoerg Sonnenberger.Re
77*ade90846SJoerg Sonnenberger.Sh AUTHORS
78*ade90846SJoerg SonnenbergerThe
79*ade90846SJoerg Sonnenberger.Nm
80*ade90846SJoerg Sonnenbergerfunction and this manual page were developed for the
81*ade90846SJoerg Sonnenberger.Fx
82*ade90846SJoerg SonnenbergerProject by ThinkSec AS and Network Associates Laboratories, the
83*ade90846SJoerg SonnenbergerSecurity Research Division of Network Associates, Inc.& under
84*ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035
85*ade90846SJoerg Sonnenberger.Pq Dq CBOSS ,
86*ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program.
87