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