[linux.git] / include / rdma / opa_addr.h

/*
 * Copyright(c) 2017 Intel Corporation.
 *
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * GPL LICENSE SUMMARY
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * BSD LICENSE
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  - Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  - Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *  - Neither the name of Intel Corporation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */

#ifndef OPA_ADDR_H
#define OPA_ADDR_H

#include <rdma/opa_smi.h>

#define	OPA_SPECIAL_OUI		(0x00066AULL)
#define OPA_MAKE_ID(x)          (cpu_to_be64(OPA_SPECIAL_OUI << 40 | (x)))
#define OPA_TO_IB_UCAST_LID(x) (((x) >= be16_to_cpu(IB_MULTICAST_LID_BASE)) \
				? 0 : x)
#define OPA_GID_INDEX		0x1
/**
 * 0xF8 - 4 bits of multicast range and 1 bit for collective range
 * Example: For 24 bit LID space,
 * Multicast range: 0xF00000 to 0xF7FFFF
 * Collective range: 0xF80000 to 0xFFFFFE
 */
#define OPA_MCAST_NR 0x4 /* Number of top bits set */
#define OPA_COLLECTIVE_NR 0x1 /* Number of bits after MCAST_NR */

/**
 * ib_is_opa_gid: Returns true if the top 24 bits of the gid
 * contains the OPA_STL_OUI identifier. This identifies that
 * the provided gid is a special purpose GID meant to carry
 * extended LID information.
 *
 * @gid: The Global identifier
 */
static inline bool ib_is_opa_gid(const union ib_gid *gid)
{
	return ((be64_to_cpu(gid->global.interface_id) >> 40) ==
		OPA_SPECIAL_OUI);
}

/**
 * opa_get_lid_from_gid: Returns the last 32 bits of the gid.
 * OPA devices use one of the gids in the gid table to also
 * store the lid.
 *
 * @gid: The Global identifier
 */
static inline u32 opa_get_lid_from_gid(const union ib_gid *gid)
{
	return be64_to_cpu(gid->global.interface_id) & 0xFFFFFFFF;
}

/**
 * opa_is_extended_lid: Returns true if dlid or slid are
 * extended.
 *
 * @dlid: The DLID
 * @slid: The SLID
 */
static inline bool opa_is_extended_lid(__be32 dlid, __be32 slid)
{
	if ((be32_to_cpu(dlid) >=
	     be16_to_cpu(IB_MULTICAST_LID_BASE)) ||
	    (be32_to_cpu(slid) >=
	     be16_to_cpu(IB_MULTICAST_LID_BASE)))
		return true;

	return false;
}

/* Get multicast lid base */
static inline u32 opa_get_mcast_base(u32 nr_top_bits)
{
	return (be32_to_cpu(OPA_LID_PERMISSIVE) << (32 - nr_top_bits));
}

/* Check for a valid unicast LID for non-SM traffic types */
static inline bool rdma_is_valid_unicast_lid(struct rdma_ah_attr *attr)
{
	if (attr->type == RDMA_AH_ATTR_TYPE_IB) {
		if (!rdma_ah_get_dlid(attr) ||
		    rdma_ah_get_dlid(attr) >=
		    be16_to_cpu(IB_MULTICAST_LID_BASE))
			return false;
	} else if (attr->type == RDMA_AH_ATTR_TYPE_OPA) {
		if (!rdma_ah_get_dlid(attr) ||
		    rdma_ah_get_dlid(attr) >=
		    opa_get_mcast_base(OPA_MCAST_NR))
			return false;
	}
	return true;
}
#endif /* OPA_ADDR_H */
Commit	Line	Data
87f0faad DL	1	/*
	2	* Copyright(c) 2017 Intel Corporation.
	3	*
	4	* This file is provided under a dual BSD/GPLv2 license. When using or
	5	* redistributing this file, you may do so under either license.
	6	*
	7	* GPL LICENSE SUMMARY
	8	*
	9	* This program is free software; you can redistribute it and/or modify
	10	* it under the terms of version 2 of the GNU General Public License as
	11	* published by the Free Software Foundation.
	12	*
	13	* This program is distributed in the hope that it will be useful, but
	14	* WITHOUT ANY WARRANTY; without even the implied warranty of
	15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	16	* General Public License for more details.
	17	*
	18	* BSD LICENSE
	19	*
	20	* Redistribution and use in source and binary forms, with or without
	21	* modification, are permitted provided that the following conditions
	22	* are met:
	23	*
	24	* - Redistributions of source code must retain the above copyright
	25	* notice, this list of conditions and the following disclaimer.
	26	* - Redistributions in binary form must reproduce the above copyright
	27	* notice, this list of conditions and the following disclaimer in
	28	* the documentation and/or other materials provided with the
	29	* distribution.
	30	* - Neither the name of Intel Corporation nor the names of its
	31	* contributors may be used to endorse or promote products derived
	32	* from this software without specific prior written permission.
	33	*
	34	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	35	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	36	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
	37	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	38	* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	39	* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	40	* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	41	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	42	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	43	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
	44	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	45	*
	46	*/
	47
	48	#ifndef OPA_ADDR_H
	49	#define OPA_ADDR_H
	50
13c19222 DH	51	#include <rdma/opa_smi.h>
13c19222 DH	52
87f0faad DL	53	#define OPA_SPECIAL_OUI (0x00066AULL)
87f0faad DL	54	#define OPA_MAKE_ID(x) (cpu_to_be64(OPA_SPECIAL_OUI << 40 \| (x)))
582faf31 DC	55	#define OPA_TO_IB_UCAST_LID(x) (((x) >= be16_to_cpu(IB_MULTICAST_LID_BASE)) \
582faf31 DC	56	? 0 : x)
88733e3b	57	#define OPA_GID_INDEX 0x1
13c19222 DH	58	/**
	59	* 0xF8 - 4 bits of multicast range and 1 bit for collective range
	60	* Example: For 24 bit LID space,
	61	* Multicast range: 0xF00000 to 0xF7FFFF
	62	* Collective range: 0xF80000 to 0xFFFFFE
	63	*/
	64	#define OPA_MCAST_NR 0x4 /* Number of top bits set */
	65	#define OPA_COLLECTIVE_NR 0x1 /* Number of bits after MCAST_NR */
	66
87f0faad DL	67	/**
	68	* ib_is_opa_gid: Returns true if the top 24 bits of the gid
	69	* contains the OPA_STL_OUI identifier. This identifies that
	70	* the provided gid is a special purpose GID meant to carry
	71	* extended LID information.
	72	*
	73	* @gid: The Global identifier
	74	*/
d98bb7f7	75	static inline bool ib_is_opa_gid(const union ib_gid *gid)
87f0faad DL	76	{
	77	return ((be64_to_cpu(gid->global.interface_id) >> 40) ==
	78	OPA_SPECIAL_OUI);
	79	}
	80
	81	/**
	82	* opa_get_lid_from_gid: Returns the last 32 bits of the gid.
	83	* OPA devices use one of the gids in the gid table to also
	84	* store the lid.
	85	*
	86	* @gid: The Global identifier
	87	*/
d98bb7f7	88	static inline u32 opa_get_lid_from_gid(const union ib_gid *gid)
87f0faad DL	89	{
	90	return be64_to_cpu(gid->global.interface_id) & 0xFFFFFFFF;
	91	}
e92aa00a HD	92
	93	/**
	94	* opa_is_extended_lid: Returns true if dlid or slid are
	95	* extended.
	96	*
	97	* @dlid: The DLID
	98	* @slid: The SLID
	99	*/
a917374e	100	static inline bool opa_is_extended_lid(__be32 dlid, __be32 slid)
e92aa00a HD	101	{
	102	if ((be32_to_cpu(dlid) >=
	103	be16_to_cpu(IB_MULTICAST_LID_BASE)) \|\|
	104	(be32_to_cpu(slid) >=
	105	be16_to_cpu(IB_MULTICAST_LID_BASE)))
	106	return true;
a917374e DH	107
a917374e DH	108	return false;
e92aa00a	109	}
13c19222 DH	110
	111	/* Get multicast lid base */
	112	static inline u32 opa_get_mcast_base(u32 nr_top_bits)
	113	{
	114	return (be32_to_cpu(OPA_LID_PERMISSIVE) << (32 - nr_top_bits));
	115	}
	116
af808ece VSD	117	/* Check for a valid unicast LID for non-SM traffic types */
	118	static inline bool rdma_is_valid_unicast_lid(struct rdma_ah_attr *attr)
	119	{
	120	if (attr->type == RDMA_AH_ATTR_TYPE_IB) {
	121	if (!rdma_ah_get_dlid(attr) \|\|
	122	rdma_ah_get_dlid(attr) >=
4eefd62c	123	be16_to_cpu(IB_MULTICAST_LID_BASE))
af808ece VSD	124	return false;
	125	} else if (attr->type == RDMA_AH_ATTR_TYPE_OPA) {
	126	if (!rdma_ah_get_dlid(attr) \|\|
	127	rdma_ah_get_dlid(attr) >=
	128	opa_get_mcast_base(OPA_MCAST_NR))
	129	return false;
	130	}
	131	return true;
	132	}
87f0faad	133	#endif /* OPA_ADDR_H */