19e39c5baSBill Taylor /*
29e39c5baSBill Taylor * CDDL HEADER START
39e39c5baSBill Taylor *
49e39c5baSBill Taylor * The contents of this file are subject to the terms of the
59e39c5baSBill Taylor * Common Development and Distribution License (the "License").
69e39c5baSBill Taylor * You may not use this file except in compliance with the License.
79e39c5baSBill Taylor *
89e39c5baSBill Taylor * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
99e39c5baSBill Taylor * or http://www.opensolaris.org/os/licensing.
109e39c5baSBill Taylor * See the License for the specific language governing permissions
119e39c5baSBill Taylor * and limitations under the License.
129e39c5baSBill Taylor *
139e39c5baSBill Taylor * When distributing Covered Code, include this CDDL HEADER in each
149e39c5baSBill Taylor * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
159e39c5baSBill Taylor * If applicable, add the following below this CDDL HEADER, with the
169e39c5baSBill Taylor * fields enclosed by brackets "[]" replaced with your own identifying
179e39c5baSBill Taylor * information: Portions Copyright [yyyy] [name of copyright owner]
189e39c5baSBill Taylor *
199e39c5baSBill Taylor * CDDL HEADER END
209e39c5baSBill Taylor */
219e39c5baSBill Taylor
229e39c5baSBill Taylor /*
239e39c5baSBill Taylor * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
249e39c5baSBill Taylor */
259e39c5baSBill Taylor
269e39c5baSBill Taylor /*
279e39c5baSBill Taylor * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
289e39c5baSBill Taylor * Use is subject to license terms.
299e39c5baSBill Taylor */
309e39c5baSBill Taylor
319e39c5baSBill Taylor /*
329e39c5baSBill Taylor *
339e39c5baSBill Taylor * MODULE: dapl_psp_create.c
349e39c5baSBill Taylor *
359e39c5baSBill Taylor * PURPOSE: Connection management
369e39c5baSBill Taylor * Description: Interfaces in this file are completely described in
379e39c5baSBill Taylor * the DAPL 1.1 API, Chapter 6, section 4
389e39c5baSBill Taylor *
399e39c5baSBill Taylor * $Id: dapl_psp_create.c,v 1.16 2003/07/25 19:24:11 sjs2 Exp $
409e39c5baSBill Taylor */
419e39c5baSBill Taylor
429e39c5baSBill Taylor #include "dapl.h"
439e39c5baSBill Taylor #include "dapl_sp_util.h"
449e39c5baSBill Taylor #include "dapl_ia_util.h"
459e39c5baSBill Taylor #include "dapl_adapter_util.h"
469e39c5baSBill Taylor
479e39c5baSBill Taylor /*
489e39c5baSBill Taylor * dapl_psp_create
499e39c5baSBill Taylor *
509e39c5baSBill Taylor * uDAPL: User Direct Access Program Library Version 1.1, 6.4.1.1
519e39c5baSBill Taylor *
529e39c5baSBill Taylor * Create a persistent Public Service Point that can recieve multiple
539e39c5baSBill Taylor * requests for connections and generate multiple connection request
549e39c5baSBill Taylor * instances that wil be delivered to the specified Event Dispatcher
559e39c5baSBill Taylor * in a notification event.
569e39c5baSBill Taylor *
579e39c5baSBill Taylor * Input:
589e39c5baSBill Taylor * ia_handle
599e39c5baSBill Taylor * conn_qual
609e39c5baSBill Taylor * evd_handle
619e39c5baSBill Taylor * psp_flags
629e39c5baSBill Taylor *
639e39c5baSBill Taylor * Output:
649e39c5baSBill Taylor * psp_handle
659e39c5baSBill Taylor *
669e39c5baSBill Taylor * Returns:
679e39c5baSBill Taylor * DAT_SUCCESS
689e39c5baSBill Taylor * DAT_INSUFFICIENT_RESOURCES
699e39c5baSBill Taylor * DAT_INVALID_PARAMETER
709e39c5baSBill Taylor * DAT_CONN_QUAL_IN_USE
719e39c5baSBill Taylor * DAT_MODEL_NOT_SUPPORTED
729e39c5baSBill Taylor */
739e39c5baSBill Taylor DAT_RETURN
dapl_psp_create(IN DAT_IA_HANDLE ia_handle,IN DAT_CONN_QUAL conn_qual,IN DAT_EVD_HANDLE evd_handle,IN DAT_PSP_FLAGS psp_flags,OUT DAT_PSP_HANDLE * psp_handle)749e39c5baSBill Taylor dapl_psp_create(
759e39c5baSBill Taylor IN DAT_IA_HANDLE ia_handle,
769e39c5baSBill Taylor IN DAT_CONN_QUAL conn_qual,
779e39c5baSBill Taylor IN DAT_EVD_HANDLE evd_handle,
789e39c5baSBill Taylor IN DAT_PSP_FLAGS psp_flags,
799e39c5baSBill Taylor OUT DAT_PSP_HANDLE *psp_handle)
809e39c5baSBill Taylor {
819e39c5baSBill Taylor DAPL_IA *ia_ptr;
829e39c5baSBill Taylor DAPL_SP *sp_ptr;
839e39c5baSBill Taylor DAPL_EVD *evd_ptr;
849e39c5baSBill Taylor DAT_BOOLEAN sp_found;
859e39c5baSBill Taylor DAT_RETURN dat_status;
869e39c5baSBill Taylor
879e39c5baSBill Taylor ia_ptr = (DAPL_IA *)ia_handle;
889e39c5baSBill Taylor dat_status = DAT_SUCCESS;
899e39c5baSBill Taylor
909e39c5baSBill Taylor if (DAPL_BAD_HANDLE(ia_ptr, DAPL_MAGIC_IA)) {
919e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_HANDLE,
929e39c5baSBill Taylor DAT_INVALID_HANDLE_IA);
939e39c5baSBill Taylor goto bail;
949e39c5baSBill Taylor }
959e39c5baSBill Taylor
969e39c5baSBill Taylor if (DAPL_BAD_HANDLE(evd_handle, DAPL_MAGIC_EVD)) {
979e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_HANDLE,
989e39c5baSBill Taylor DAT_INVALID_HANDLE_EVD_CR);
999e39c5baSBill Taylor goto bail;
1009e39c5baSBill Taylor }
1019e39c5baSBill Taylor
1029e39c5baSBill Taylor if (psp_handle == NULL) {
1039e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_PARAMETER, DAT_INVALID_ARG5);
1049e39c5baSBill Taylor goto bail;
1059e39c5baSBill Taylor }
1069e39c5baSBill Taylor
1079e39c5baSBill Taylor /* check for invalid psp flags */
1089e39c5baSBill Taylor if ((psp_flags != DAT_PSP_CONSUMER_FLAG) &&
1099e39c5baSBill Taylor (psp_flags != DAT_PSP_PROVIDER_FLAG)) {
1109e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_PARAMETER, DAT_INVALID_ARG4);
1119e39c5baSBill Taylor goto bail;
1129e39c5baSBill Taylor }
1139e39c5baSBill Taylor
1149e39c5baSBill Taylor evd_ptr = (DAPL_EVD *)evd_handle;
1159e39c5baSBill Taylor if (!(evd_ptr->evd_flags & DAT_EVD_CR_FLAG)) {
1169e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_HANDLE,
1179e39c5baSBill Taylor DAT_INVALID_HANDLE_EVD_CR);
1189e39c5baSBill Taylor goto bail;
1199e39c5baSBill Taylor }
1209e39c5baSBill Taylor
1219e39c5baSBill Taylor /*
1229e39c5baSBill Taylor * check for connection qualifier eq 0
1239e39c5baSBill Taylor * in IB this is called Null Service ID, use of it in CM is invalid.
1249e39c5baSBill Taylor * in tcp/udp, port number 0 is reserved.
1259e39c5baSBill Taylor */
1269e39c5baSBill Taylor if (!conn_qual) {
1279e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INVALID_PARAMETER, DAT_INVALID_ARG2);
1289e39c5baSBill Taylor goto bail;
1299e39c5baSBill Taylor }
1309e39c5baSBill Taylor
1319e39c5baSBill Taylor /*
1329e39c5baSBill Taylor * See if we have a quiescent listener to use for this PSP, else
1339e39c5baSBill Taylor * create one and set it listening
1349e39c5baSBill Taylor */
1359e39c5baSBill Taylor sp_ptr = dapls_ia_sp_search(ia_ptr, conn_qual, DAT_TRUE);
1369e39c5baSBill Taylor sp_found = DAT_TRUE;
1379e39c5baSBill Taylor if (sp_ptr == NULL) {
1389e39c5baSBill Taylor /* Allocate PSP */
1399e39c5baSBill Taylor sp_found = DAT_FALSE;
1409e39c5baSBill Taylor sp_ptr = dapls_sp_alloc(ia_ptr, DAT_TRUE);
1419e39c5baSBill Taylor
1429e39c5baSBill Taylor if (sp_ptr == NULL) {
1439e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_INSUFFICIENT_RESOURCES,
1449e39c5baSBill Taylor DAT_RESOURCE_MEMORY);
1459e39c5baSBill Taylor goto bail;
1469e39c5baSBill Taylor }
1479e39c5baSBill Taylor } else if (sp_ptr->listening == DAT_TRUE) {
1489e39c5baSBill Taylor dat_status = DAT_ERROR(DAT_CONN_QUAL_IN_USE, 0);
1499e39c5baSBill Taylor goto bail;
1509e39c5baSBill Taylor }
1519e39c5baSBill Taylor
1529e39c5baSBill Taylor /*
1539e39c5baSBill Taylor * Fill out the args for a PSP
1549e39c5baSBill Taylor */
1559e39c5baSBill Taylor sp_ptr->ia_handle = ia_handle;
1569e39c5baSBill Taylor sp_ptr->conn_qual = conn_qual;
1579e39c5baSBill Taylor sp_ptr->evd_handle = evd_handle;
1589e39c5baSBill Taylor sp_ptr->psp_flags = psp_flags;
1599e39c5baSBill Taylor sp_ptr->ep_handle = NULL;
1609e39c5baSBill Taylor
1619e39c5baSBill Taylor /*
1629e39c5baSBill Taylor * Take a reference on the EVD handle
1639e39c5baSBill Taylor */
164*fb4cdc19SToomas Soome dapl_os_atomic_inc(&((DAPL_EVD *)evd_handle)->evd_ref_count);
1659e39c5baSBill Taylor
1669e39c5baSBill Taylor /*
1679e39c5baSBill Taylor * Set up a listener for a connection. Connections can arrive
1689e39c5baSBill Taylor * even before this call returns!
1699e39c5baSBill Taylor */
1709e39c5baSBill Taylor sp_ptr->state = DAPL_SP_STATE_PSP_LISTENING;
1719e39c5baSBill Taylor sp_ptr->listening = DAT_TRUE;
1729e39c5baSBill Taylor
1739e39c5baSBill Taylor /*
1749e39c5baSBill Taylor * If this is a new sp we need to add it to the IA queue, and set up
1759e39c5baSBill Taylor * a conn_listener.
1769e39c5baSBill Taylor */
1779e39c5baSBill Taylor if (sp_found == DAT_FALSE) {
1789e39c5baSBill Taylor
1799e39c5baSBill Taylor /* Link it onto the IA */
1809e39c5baSBill Taylor dapl_ia_link_psp(ia_ptr, sp_ptr);
1819e39c5baSBill Taylor
1829e39c5baSBill Taylor dat_status = dapls_ib_setup_conn_listener(ia_ptr, conn_qual,
1839e39c5baSBill Taylor sp_ptr);
1849e39c5baSBill Taylor
1859e39c5baSBill Taylor if (dat_status != DAT_SUCCESS) {
1869e39c5baSBill Taylor /*
1879e39c5baSBill Taylor * Have a problem setting up the connection, something
1889e39c5baSBill Taylor * wrong! The psp_free decrements the EVD refcount for
1899e39c5baSBill Taylor * us; we don't * need to do that.
1909e39c5baSBill Taylor * But we want to set the listener bits to false,
1919e39c5baSBill Taylor * as we know that call failed.
1929e39c5baSBill Taylor */
1939e39c5baSBill Taylor sp_ptr->state = DAPL_SP_STATE_FREE;
1949e39c5baSBill Taylor sp_ptr->listening = DAT_FALSE;
1959e39c5baSBill Taylor (void) dapl_psp_free((DAT_PSP_HANDLE) sp_ptr);
1969e39c5baSBill Taylor
1979e39c5baSBill Taylor dapl_dbg_log(DAPL_DBG_TYPE_CM,
1989e39c5baSBill Taylor "--> dapl_psp_create setup_conn_listener failed: "
1999e39c5baSBill Taylor "%x\n",
2009e39c5baSBill Taylor dat_status);
2019e39c5baSBill Taylor
2029e39c5baSBill Taylor goto bail;
2039e39c5baSBill Taylor }
2049e39c5baSBill Taylor }
2059e39c5baSBill Taylor
2069e39c5baSBill Taylor /*
2079e39c5baSBill Taylor * Return handle to the user
2089e39c5baSBill Taylor */
2099e39c5baSBill Taylor *psp_handle = (DAT_PSP_HANDLE)sp_ptr;
2109e39c5baSBill Taylor
2119e39c5baSBill Taylor bail:
2129e39c5baSBill Taylor return (dat_status);
2139e39c5baSBill Taylor }
214