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 2004 Sun Microsystems, Inc. All rights reserved.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Use is subject to license terms.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Vendor provides values for their implementation. Most of
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * these values are returned in the DAT_IA_ATTR parameter of
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * dat_ia_query()
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT_IA_ATTR attributes
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * These values are used in the provider support routine
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * dapls_ib_query_hca (). Many of the values there are HW
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * specific, the the vendor should look to make sure they are
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * appropriate for their implementation. Specifically,
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * vendors are encouraged to update transport and vendor
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * attributes: the reference implementation sets these to NULL.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Product name of the adapter.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Returned in DAT_IA_ATTR.adapter_name
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * adapter name is limited to DAT_NAME_MAX_LENGTH
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Vendor name
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Returned in DAT_IA_ATTR.vendor_name
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * PROVIDER Attributes
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * These values are used in ./common/dapl_ia_query.c, in dapl_ia_query ().
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * The values below are the most common for vendors to change, but
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * there are several other values that may be updated once the
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * implementation becomes mature.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Provider Versions
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Returned in DAT_PROVIDER_ATTR.provider_version_major and
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT_PROVIDER_ATTR.provider_version_minor
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Provider support for memory types. The reference implementation
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * always supports DAT_MEM_TYPE_VIRTUAL and DAT_MEM_TYPE_LMR, so
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * the vendor must indicate if they support DAT_MEM_TYPE_SHARED_VIRTUAL.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Set this value to '1' if DAT_MEM_TYPE_SHARED_VIRTUAL is supported.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Returned in DAT_PROVIDER_ATTR.lmr_mem_types_supported
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * This value will be assigned to dev_name_prefix in ./udapl/dapl_init.c.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * DAT is designed to support multiple DAPL instances simultaneously,
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * with different dapl libraries originating from different providers.
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * There is always the possibility of name conflicts, so a dat name
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * prefix is provided to make a vendor's adapter name unique. This is
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * especially true of the IBM Access API, which returns adapter
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * names that are simply ordinal numbers (e.g. 0, 1, 2). If
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * a vendor doesn't need or want a prefix, it should be left
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * as a NULL (use "").
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * Values that might be used:
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * #define VN_PREFIX "jni" (JNI: OS Acces API)
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * #define VN_PREFIX "ibm" (IBM: OS Acces API)
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * #define VN_PREFIX "" (Mellanox: VAPI)
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor * #define VN_PREFIX "" (Intel: IB Common API)
9e39c5ba00a55fa05777cc94b148296af305e135Bill Taylor#endif /* _DAPL_VENDOR_H_ */