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