9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * CDDL HEADER START
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * The contents of this file are subject to the terms of the
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Common Development and Distribution License (the "License").
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * You may not use this file except in compliance with the License.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * See the License for the specific language governing permissions
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * and limitations under the License.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * When distributing Covered Code, include this CDDL HEADER in each
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * If applicable, add the following below this CDDL HEADER, with the
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * fields enclosed by brackets "[]" replaced with your own identifying
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * information: Portions Copyright [yyyy] [name of copyright owner]
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * CDDL HEADER END
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Use is subject to license terms.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * PURPOSE: Endpoint management
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Description: Interfaces in this file are completely described in
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * the DAPL 1.1 API, Chapter 6, section 5.4
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * $Id: dapl_ep_free.c,v 1.21 2003/07/30 18:13:37 hobie16 Exp $
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * dapl_ep_free
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAPL Requirements Version xxx, 6.5.3
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Destroy an instance of the Endpoint
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT_SUCCESS
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT_INVALID_PARAMETER
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT_INVALID_STATE
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor dapl_dbg_log(DAPL_DBG_TYPE_API, "dapl_ep_free (%p)\n", ep_handle);
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Verify parameter & state
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_DISCONNECTED)) {
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor if (ep_ptr->param.ep_state == DAT_EP_STATE_RESERVED ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_PASSIVE_CONNECTION_PENDING ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor "--> dapl_ep_free: invalid state: %x, ep %p\n",
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * If we are connected, issue a disconnect. If we are in the
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * disconnect_pending state, disconnect with the ABRUPT flag
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Do verification of parameters and the state change atomically.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor if (ep_ptr->param.ep_state == DAT_EP_STATE_CONNECTED ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_ACTIVE_CONNECTION_PENDING ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_COMPLETION_PENDING ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_DISCONNECT_PENDING) {
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Issue the disconnect and return. The DISCONNECT callback
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * will invoke this routine and finish the job
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state = DAT_EP_STATE_DISCONNECT_PENDING;
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor "--> dapl_ep_free: disconnecting EP: %x, ep %p\n",
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor dat_status = dapls_ib_disconnect(ep_ptr, DAT_CLOSE_ABRUPT_FLAG);
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state = DAT_EP_STATE_DISCONNECT_PENDING;
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Release all reference counts and unlink this structure. If we
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * got here from a callback, don't repeat this step
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor if (!(ep_ptr->header.magic == DAPL_MAGIC_EP_EXIT &&
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_DISCONNECTED)) {
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor /* Remove link from the IA */
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * If the EP is disconnected tear everything down. Otherwise,
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * disconnect the EP but leave the QP and basic EP structure
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * intact; the callback code will finish the job.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor if (ep_ptr->param.ep_state == DAT_EP_STATE_DISCONNECTED ||
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor ep_ptr->param.ep_state == DAT_EP_STATE_UNCONNECTED) {
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Update ref counts. Note the user may have used ep_modify
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * to set handles to NULL.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor "--> dapl_ep_free: Free EP: %x, ep %p\n",
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Free the QP. If the EP has never been used,
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * the QP is invalid
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * This should always succeed, but report to the user if
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * there is a problem
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor /* Free the resource */