1*9e39c5baSBill Taylor /*
2*9e39c5baSBill Taylor  * CDDL HEADER START
3*9e39c5baSBill Taylor  *
4*9e39c5baSBill Taylor  * The contents of this file are subject to the terms of the
5*9e39c5baSBill Taylor  * Common Development and Distribution License (the "License").
6*9e39c5baSBill Taylor  * You may not use this file except in compliance with the License.
7*9e39c5baSBill Taylor  *
8*9e39c5baSBill Taylor  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*9e39c5baSBill Taylor  * or http://www.opensolaris.org/os/licensing.
10*9e39c5baSBill Taylor  * See the License for the specific language governing permissions
11*9e39c5baSBill Taylor  * and limitations under the License.
12*9e39c5baSBill Taylor  *
13*9e39c5baSBill Taylor  * When distributing Covered Code, include this CDDL HEADER in each
14*9e39c5baSBill Taylor  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*9e39c5baSBill Taylor  * If applicable, add the following below this CDDL HEADER, with the
16*9e39c5baSBill Taylor  * fields enclosed by brackets "[]" replaced with your own identifying
17*9e39c5baSBill Taylor  * information: Portions Copyright [yyyy] [name of copyright owner]
18*9e39c5baSBill Taylor  *
19*9e39c5baSBill Taylor  * CDDL HEADER END
20*9e39c5baSBill Taylor  */
21*9e39c5baSBill Taylor 
22*9e39c5baSBill Taylor /*
23*9e39c5baSBill Taylor  * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
24*9e39c5baSBill Taylor  */
25*9e39c5baSBill Taylor 
26*9e39c5baSBill Taylor /*
27*9e39c5baSBill Taylor  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
28*9e39c5baSBill Taylor  * Use is subject to license terms.
29*9e39c5baSBill Taylor  */
30*9e39c5baSBill Taylor 
31*9e39c5baSBill Taylor /*
32*9e39c5baSBill Taylor  *
33*9e39c5baSBill Taylor  * MODULE: dapl_rsp_free.c
34*9e39c5baSBill Taylor  *
35*9e39c5baSBill Taylor  * PURPOSE: Connection management
36*9e39c5baSBill Taylor  * Description: Interfaces in this file are completely described in
37*9e39c5baSBill Taylor  *		the DAPL 1.1 API, Chapter 6, section 4
38*9e39c5baSBill Taylor  *
39*9e39c5baSBill Taylor  * $Id: dapl_rsp_free.c,v 1.16 2003/07/25 19:24:11 sjs2 Exp $
40*9e39c5baSBill Taylor  */
41*9e39c5baSBill Taylor 
42*9e39c5baSBill Taylor #include "dapl.h"
43*9e39c5baSBill Taylor #include "dapl_sp_util.h"
44*9e39c5baSBill Taylor #include "dapl_ia_util.h"
45*9e39c5baSBill Taylor #include "dapl_adapter_util.h"
46*9e39c5baSBill Taylor 
47*9e39c5baSBill Taylor /*
48*9e39c5baSBill Taylor  * dapl_rsp_free
49*9e39c5baSBill Taylor  *
50*9e39c5baSBill Taylor  * uDAPL: User Direct Access Program Library Version 1.1, 6.4.3.5
51*9e39c5baSBill Taylor  *
52*9e39c5baSBill Taylor  * Destroy a specific instance of a Reserved Service Point.
53*9e39c5baSBill Taylor  *
54*9e39c5baSBill Taylor  * Input:
55*9e39c5baSBill Taylor  *	rsp_handle
56*9e39c5baSBill Taylor  *
57*9e39c5baSBill Taylor  * Output:
58*9e39c5baSBill Taylor  *	none
59*9e39c5baSBill Taylor  *
60*9e39c5baSBill Taylor  * Returns:
61*9e39c5baSBill Taylor  *	DAT_SUCCESS
62*9e39c5baSBill Taylor  *	DAT_INVALID_HANDLE
63*9e39c5baSBill Taylor  */
64*9e39c5baSBill Taylor DAT_RETURN
dapl_rsp_free(IN DAT_RSP_HANDLE rsp_handle)65*9e39c5baSBill Taylor dapl_rsp_free(
66*9e39c5baSBill Taylor 	IN	DAT_RSP_HANDLE	   rsp_handle)
67*9e39c5baSBill Taylor {
68*9e39c5baSBill Taylor 	DAPL_IA		*ia_ptr;
69*9e39c5baSBill Taylor 	DAPL_SP		*sp_ptr;
70*9e39c5baSBill Taylor 	DAPL_EP		*ep_ptr;
71*9e39c5baSBill Taylor 	DAT_RETURN		dat_status;
72*9e39c5baSBill Taylor 
73*9e39c5baSBill Taylor 	dat_status = DAT_SUCCESS;
74*9e39c5baSBill Taylor 
75*9e39c5baSBill Taylor 	sp_ptr = (DAPL_SP *)rsp_handle;
76*9e39c5baSBill Taylor 	/*
77*9e39c5baSBill Taylor 	 * Verify handle
78*9e39c5baSBill Taylor 	 */
79*9e39c5baSBill Taylor 	dapl_dbg_log(DAPL_DBG_TYPE_CM,
80*9e39c5baSBill Taylor 	    ">>> dapl_rsp_free %p\n",
81*9e39c5baSBill Taylor 	    rsp_handle);
82*9e39c5baSBill Taylor 	if (DAPL_BAD_HANDLE(sp_ptr, DAPL_MAGIC_RSP)) {
83*9e39c5baSBill Taylor 		dat_status = DAT_ERROR(DAT_INVALID_HANDLE,
84*9e39c5baSBill Taylor 		    DAT_INVALID_HANDLE_RSP);
85*9e39c5baSBill Taylor 		goto bail;
86*9e39c5baSBill Taylor 	}
87*9e39c5baSBill Taylor 
88*9e39c5baSBill Taylor 	/* ia_ptr = (DAPL_IA *)sp_ptr->header.owner_ia; */
89*9e39c5baSBill Taylor 	ia_ptr = sp_ptr->header.owner_ia;
90*9e39c5baSBill Taylor 
91*9e39c5baSBill Taylor 	/*
92*9e39c5baSBill Taylor 	 * Remove the connection listener if there are no connections.  If
93*9e39c5baSBill Taylor 	 * we defer removing the sp it becomes something of a zombie
94*9e39c5baSBill Taylor 	 * container until disconnection, after which it will be cleaned up.
95*9e39c5baSBill Taylor 	 */
96*9e39c5baSBill Taylor 	dapl_os_lock(&sp_ptr->header.lock);
97*9e39c5baSBill Taylor 
98*9e39c5baSBill Taylor 	/*
99*9e39c5baSBill Taylor 	 * Make sure we don't leave a dangling EP. If the state is still
100*9e39c5baSBill Taylor 	 * RESERVED then the RSP still owns it.
101*9e39c5baSBill Taylor 	 */
102*9e39c5baSBill Taylor 	ep_ptr = (DAPL_EP *)sp_ptr->ep_handle;
103*9e39c5baSBill Taylor 	if (ep_ptr->param.ep_state == DAT_EP_STATE_RESERVED) {
104*9e39c5baSBill Taylor 		ep_ptr->param.ep_state = DAT_EP_STATE_UNCONNECTED;
105*9e39c5baSBill Taylor 	}
106*9e39c5baSBill Taylor 	sp_ptr->ep_handle = NULL;
107*9e39c5baSBill Taylor 
108*9e39c5baSBill Taylor 	/* Release reference on EVD */
109*9e39c5baSBill Taylor 	dapl_os_atomic_dec(&((DAPL_EVD *)sp_ptr->evd_handle)->evd_ref_count);
110*9e39c5baSBill Taylor 	sp_ptr->evd_handle = NULL;
111*9e39c5baSBill Taylor 
112*9e39c5baSBill Taylor 	/*
113*9e39c5baSBill Taylor 	 * Release the base resource if there are no outstanding connections;
114*9e39c5baSBill Taylor 	 * else the last disconnect on this RSP will free it up. The RSP
115*9e39c5baSBill Taylor 	 * is used to contain CR records for each connection, which
116*9e39c5baSBill Taylor 	 * contain information necessary to disconnect.
117*9e39c5baSBill Taylor 	 */
118*9e39c5baSBill Taylor 	if (sp_ptr->listening == DAT_TRUE && sp_ptr->cr_list_count == 0) {
119*9e39c5baSBill Taylor 		sp_ptr->listening	= DAT_FALSE;
120*9e39c5baSBill Taylor 		sp_ptr->state		= DAPL_SP_STATE_FREE;
121*9e39c5baSBill Taylor 		dapl_os_unlock(&sp_ptr->header.lock);
122*9e39c5baSBill Taylor 		dat_status = dapls_ib_remove_conn_listener(ia_ptr, sp_ptr);
123*9e39c5baSBill Taylor 		if (dat_status != DAT_SUCCESS) {
124*9e39c5baSBill Taylor 			sp_ptr->listening = DAT_TRUE;
125*9e39c5baSBill Taylor 			sp_ptr->state = DAPL_SP_STATE_RSP_LISTENING;
126*9e39c5baSBill Taylor 			goto bail;
127*9e39c5baSBill Taylor 		}
128*9e39c5baSBill Taylor 		dapls_ia_unlink_sp(ia_ptr, sp_ptr);
129*9e39c5baSBill Taylor 		dapls_sp_free_sp(sp_ptr);
130*9e39c5baSBill Taylor 
131*9e39c5baSBill Taylor 	} else {
132*9e39c5baSBill Taylor 		/*
133*9e39c5baSBill Taylor 		 * The RSP is now in the pending state, where it will sit until
134*9e39c5baSBill Taylor 		 * the connection terminates or the app uses the same
135*9e39c5baSBill Taylor 		 * ServiceID again, which will reactivate it.
136*9e39c5baSBill Taylor 		 */
137*9e39c5baSBill Taylor 		sp_ptr->state = DAPL_SP_STATE_RSP_PENDING;
138*9e39c5baSBill Taylor 		dapl_os_unlock(&sp_ptr->header.lock);
139*9e39c5baSBill Taylor 	}
140*9e39c5baSBill Taylor 
141*9e39c5baSBill Taylor bail:
142*9e39c5baSBill Taylor 	return (dat_status);
143*9e39c5baSBill Taylor }
144*9e39c5baSBill Taylor 
145*9e39c5baSBill Taylor /*
146*9e39c5baSBill Taylor  * Local variables:
147*9e39c5baSBill Taylor  *  c-indent-level: 4
148*9e39c5baSBill Taylor  *  c-basic-offset: 4
149*9e39c5baSBill Taylor  *  c-brace-offset: -4
150*9e39c5baSBill Taylor  *  tab-width: 8
151*9e39c5baSBill Taylor  * End:
152*9e39c5baSBill Taylor  */
153