On 26-Feb-19 23:04, Steve Wise wrote:
>
> On 2/21/2019 9:33 AM, Gal Pressman wrote:
>> Add the EFA ABI file exposed to userspace.
>>
>> Signed-off-by: Gal Pressman <galpress@xxxxxxxxxx>
>> ---
>> include/uapi/rdma/efa-abi.h | 129 ++++++++++++++++++++++++++++++++++++++++++++
>> 1 file changed, 129 insertions(+)
>> create mode 100644 include/uapi/rdma/efa-abi.h
>>
>> diff --git a/include/uapi/rdma/efa-abi.h b/include/uapi/rdma/efa-abi.h
>> new file mode 100644
>> index 000000000000..a97373cdfbd2
>> --- /dev/null
>> +++ b/include/uapi/rdma/efa-abi.h
>> @@ -0,0 +1,129 @@
>> +/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause) */
>> +/*
>> + * Copyright 2018-2019 Amazon.com, Inc. or its affiliates. All rights reserved.
>> + *
>> + * This software is available to you under a choice of one of two
>> + * licenses. You may choose to be licensed under the terms of the GNU
>> + * General Public License (GPL) Version 2, available from the file
>> + * COPYING in the main directory of this source tree, or the
>> + * BSD license below:
>> + *
>> + * 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.
>> + *
>> + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
>> + * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
>> + * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
>> + * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
>> + * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
>> + * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
>> + * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
>> + * SOFTWARE.
>> + */
>> +
>> +#ifndef EFA_ABI_USER_H
>> +#define EFA_ABI_USER_H
>> +
>> +#include <linux/types.h>
>> +
>> +/*
>> + * Increment this value if any changes that break userspace ABI
>> + * compatibility are made.
>> + */
>> +#define EFA_UVERBS_ABI_VERSION 1
>> +
>> +/*
>> + * Keep structs aligned to 8 bytes.
>> + * Keep reserved fields as arrays of __u8 named reserved_XXX where XXX is the
>> + * hex bit offset of the field.
>> + */
>> +
>> +enum efa_ibv_user_cmds_supp_udata {
>> + EFA_USER_CMDS_SUPP_UDATA_QUERY_DEVICE = 1 << 0,
>> + EFA_USER_CMDS_SUPP_UDATA_CREATE_AH = 1 << 1,
>> +};
>> +
>> +struct efa_ibv_alloc_ucontext_resp {
>> + __u32 comp_mask;
>> + __u32 cmds_supp_udata_mask;
>> + __u16 sub_cqs_per_cq;
>> + __u16 inline_buf_size;
>> + __u32 max_llq_size; /* bytes */
>> +};
>> +
>> +struct efa_ibv_alloc_pd_resp {
>> + __u32 comp_mask;
>> + __u16 pdn;
>> + __u8 reserved_30[0x2];
>> +};
>> +
>> +struct efa_ibv_create_cq {
>> + __u32 comp_mask;
>> + __u32 cq_entry_size;
>> + __u16 num_sub_cqs;
>> + __u8 reserved_50[0x6];
>
>
> Why use hex for the array depth in these reserved bytes?
>
>
>> +};
>> +
>> +struct efa_ibv_create_cq_resp {
>> + __u32 comp_mask;
>> + __u8 reserved_20[0x4];
>> + __aligned_u64 q_mmap_key;
>> + __aligned_u64 q_mmap_size;
>> + __u16 cq_idx;
>> + __u8 reserved_d0[0x6];
>> +};
>> +
>> +enum {
>> + EFA_QP_DRIVER_TYPE_SRD = 0,
>> +};
>> +
>> +struct efa_ibv_create_qp {
>> + __u32 comp_mask;
>> + __u32 rq_ring_size; /* bytes */
>> + __u32 sq_ring_size; /* bytes */
>> + __u32 driver_qp_type;
>> +};
>> +
>> +struct efa_ibv_create_qp_resp {
>> + __u32 comp_mask;
>> + /* the offset inside the page of the rq db */
>> + __u32 rq_db_offset;
>> + /* the offset inside the page of the sq db */
>> + __u32 sq_db_offset;
>> + /* the offset inside the page of descriptors buffer */
>> + __u32 llq_desc_offset;
>> + __aligned_u64 rq_mmap_key;
>> + __aligned_u64 rq_mmap_size;
>> + __aligned_u64 rq_db_mmap_key;
>> + __aligned_u64 sq_db_mmap_key;
>> + __aligned_u64 llq_desc_mmap_key;
>> + __u16 send_sub_cq_idx;
>> + __u16 recv_sub_cq_idx;
>> + __u8 reserved_1e0[0x4];
>> +};
>> +
>> +struct efa_ibv_create_ah_resp {
>> + __u32 comp_mask;
>> + __u16 efa_address_handle;
>> + __u8 reserved_30[0x2];
>> +};
>> +
>> +struct efa_ibv_ex_query_device_resp {
>> + __u32 comp_mask;
>> + __u32 max_sq_wr;
>> + __u32 max_rq_wr;
>> + __u16 max_sq_sge;
>> + __u16 max_rq_sge;
>> +};
>> +
>> +#endif /* EFA_ABI_USER_H */
>
>
> Reviewed-by: Steve Wise <swise@xxxxxxxxxxxxxxxxxxxxx>
Thanks Steve!
