xref: /dflybsd-src/contrib/openpam/lib/libpam/pam_end.c (revision 7031abe4d1ef8c309d4113438494530b74f3f3fe)
1*10b5fe87SSascha Wildner /*-
2*10b5fe87SSascha Wildner  * Copyright (c) 2002-2003 Networks Associates Technology, Inc.
3*10b5fe87SSascha Wildner  * Copyright (c) 2004-2017 Dag-Erling Smørgrav
4*10b5fe87SSascha Wildner  * All rights reserved.
5*10b5fe87SSascha Wildner  *
6*10b5fe87SSascha Wildner  * This software was developed for the FreeBSD Project by ThinkSec AS and
7*10b5fe87SSascha Wildner  * Network Associates Laboratories, the Security Research Division of
8*10b5fe87SSascha Wildner  * Network Associates, Inc.  under DARPA/SPAWAR contract N66001-01-C-8035
9*10b5fe87SSascha Wildner  * ("CBOSS"), as part of the DARPA CHATS research program.
10*10b5fe87SSascha Wildner  *
11*10b5fe87SSascha Wildner  * Redistribution and use in source and binary forms, with or without
12*10b5fe87SSascha Wildner  * modification, are permitted provided that the following conditions
13*10b5fe87SSascha Wildner  * are met:
14*10b5fe87SSascha Wildner  * 1. Redistributions of source code must retain the above copyright
15*10b5fe87SSascha Wildner  *    notice, this list of conditions and the following disclaimer.
16*10b5fe87SSascha Wildner  * 2. Redistributions in binary form must reproduce the above copyright
17*10b5fe87SSascha Wildner  *    notice, this list of conditions and the following disclaimer in the
18*10b5fe87SSascha Wildner  *    documentation and/or other materials provided with the distribution.
19*10b5fe87SSascha Wildner  * 3. The name of the author may not be used to endorse or promote
20*10b5fe87SSascha Wildner  *    products derived from this software without specific prior written
21*10b5fe87SSascha Wildner  *    permission.
22*10b5fe87SSascha Wildner  *
23*10b5fe87SSascha Wildner  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
24*10b5fe87SSascha Wildner  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25*10b5fe87SSascha Wildner  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26*10b5fe87SSascha Wildner  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27*10b5fe87SSascha Wildner  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28*10b5fe87SSascha Wildner  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29*10b5fe87SSascha Wildner  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30*10b5fe87SSascha Wildner  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31*10b5fe87SSascha Wildner  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32*10b5fe87SSascha Wildner  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33*10b5fe87SSascha Wildner  * SUCH DAMAGE.
34*10b5fe87SSascha Wildner  *
35*10b5fe87SSascha Wildner  * $OpenPAM: pam_end.c 938 2017-04-30 21:34:42Z des $
36*10b5fe87SSascha Wildner  */
37*10b5fe87SSascha Wildner 
38*10b5fe87SSascha Wildner #ifdef HAVE_CONFIG_H
39*10b5fe87SSascha Wildner # include "config.h"
40*10b5fe87SSascha Wildner #endif
41*10b5fe87SSascha Wildner 
42*10b5fe87SSascha Wildner #include <stdlib.h>
43*10b5fe87SSascha Wildner 
44*10b5fe87SSascha Wildner #include <security/pam_appl.h>
45*10b5fe87SSascha Wildner 
46*10b5fe87SSascha Wildner #include "openpam_impl.h"
47*10b5fe87SSascha Wildner 
48*10b5fe87SSascha Wildner /*
49*10b5fe87SSascha Wildner  * XSSO 4.2.1
50*10b5fe87SSascha Wildner  * XSSO 6 page 42
51*10b5fe87SSascha Wildner  *
52*10b5fe87SSascha Wildner  * Terminate the PAM transaction
53*10b5fe87SSascha Wildner  */
54*10b5fe87SSascha Wildner 
55*10b5fe87SSascha Wildner int
pam_end(pam_handle_t * pamh,int status)56*10b5fe87SSascha Wildner pam_end(pam_handle_t *pamh,
57*10b5fe87SSascha Wildner 	int status)
58*10b5fe87SSascha Wildner {
59*10b5fe87SSascha Wildner 	pam_data_t *dp;
60*10b5fe87SSascha Wildner 	int i;
61*10b5fe87SSascha Wildner 
62*10b5fe87SSascha Wildner 	ENTER();
63*10b5fe87SSascha Wildner 	if (pamh == NULL)
64*10b5fe87SSascha Wildner 		RETURNC(PAM_BAD_HANDLE);
65*10b5fe87SSascha Wildner 
66*10b5fe87SSascha Wildner 	/* clear module data */
67*10b5fe87SSascha Wildner 	while ((dp = pamh->module_data) != NULL) {
68*10b5fe87SSascha Wildner 		if (dp->cleanup)
69*10b5fe87SSascha Wildner 			(dp->cleanup)(pamh, dp->data, status);
70*10b5fe87SSascha Wildner 		pamh->module_data = dp->next;
71*10b5fe87SSascha Wildner 		FREE(dp->name);
72*10b5fe87SSascha Wildner 		FREE(dp);
73*10b5fe87SSascha Wildner 	}
74*10b5fe87SSascha Wildner 
75*10b5fe87SSascha Wildner 	/* clear environment */
76*10b5fe87SSascha Wildner 	while (pamh->env_count) {
77*10b5fe87SSascha Wildner 		--pamh->env_count;
78*10b5fe87SSascha Wildner 		FREE(pamh->env[pamh->env_count]);
79*10b5fe87SSascha Wildner 	}
80*10b5fe87SSascha Wildner 	FREE(pamh->env);
81*10b5fe87SSascha Wildner 
82*10b5fe87SSascha Wildner 	/* clear chains */
83*10b5fe87SSascha Wildner 	openpam_clear_chains(pamh->chains);
84*10b5fe87SSascha Wildner 
85*10b5fe87SSascha Wildner 	/* clear items */
86*10b5fe87SSascha Wildner 	for (i = 0; i < PAM_NUM_ITEMS; ++i)
87*10b5fe87SSascha Wildner 		pam_set_item(pamh, i, NULL);
88*10b5fe87SSascha Wildner 
89*10b5fe87SSascha Wildner 	FREE(pamh);
90*10b5fe87SSascha Wildner 
91*10b5fe87SSascha Wildner 	RETURNC(PAM_SUCCESS);
92*10b5fe87SSascha Wildner }
93*10b5fe87SSascha Wildner 
94*10b5fe87SSascha Wildner /*
95*10b5fe87SSascha Wildner  * Error codes:
96*10b5fe87SSascha Wildner  *
97*10b5fe87SSascha Wildner  *	PAM_BAD_HANDLE
98*10b5fe87SSascha Wildner  */
99*10b5fe87SSascha Wildner 
100*10b5fe87SSascha Wildner /**
101*10b5fe87SSascha Wildner  * The =pam_end function terminates a PAM transaction and destroys the
102*10b5fe87SSascha Wildner  * corresponding PAM context, releasing all resources allocated to it.
103*10b5fe87SSascha Wildner  *
104*10b5fe87SSascha Wildner  * The =status argument should be set to the error code returned by the
105*10b5fe87SSascha Wildner  * last API call before the call to =pam_end.
106*10b5fe87SSascha Wildner  */
107