/* * Copyright (c) 2013-2017 Intel Corporation. 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 FI_DOMAIN_H #define FI_DOMAIN_H #include #include #ifdef __cplusplus extern "C" { #endif /* * AV = Address Vector * Maps and stores transport/network addresses. */ #define FI_SYMMETRIC (1ULL << 59) #define FI_SYNC_ERR (1ULL << 58) struct fi_av_attr { enum fi_av_type type; int rx_ctx_bits; size_t count; size_t ep_per_node; const char *name; void *map_addr; uint64_t flags; }; struct fi_ops_av { size_t size; int (*insert)(struct fid_av *av, const void *addr, size_t count, fi_addr_t *fi_addr, uint64_t flags, void *context); int (*insertsvc)(struct fid_av *av, const char *node, const char *service, fi_addr_t *fi_addr, uint64_t flags, void *context); int (*insertsym)(struct fid_av *av, const char *node, size_t nodecnt, const char *service, size_t svccnt, fi_addr_t *fi_addr, uint64_t flags, void *context); int (*remove)(struct fid_av *av, fi_addr_t *fi_addr, size_t count, uint64_t flags); int (*lookup)(struct fid_av *av, fi_addr_t fi_addr, void *addr, size_t *addrlen); const char * (*straddr)(struct fid_av *av, const void *addr, char *buf, size_t *len); }; struct fid_av { struct fid fid; struct fi_ops_av *ops; }; /* * MR = Memory Region * Tracks registered memory regions, primarily for remote access, * but also for local access until we can remove that need. */ struct fid_mr { struct fid fid; void *mem_desc; uint64_t key; }; struct fi_mr_attr { const struct iovec *mr_iov; size_t iov_count; uint64_t access; uint64_t offset; uint64_t requested_key; void *context; size_t auth_key_size; uint8_t *auth_key; }; struct fi_mr_modify { uint64_t flags; struct fi_mr_attr attr; }; #ifdef FABRIC_DIRECT #include #endif /* FABRIC_DIRECT */ #ifndef FABRIC_DIRECT_ATOMIC_DEF enum fi_datatype { FI_INT8, FI_UINT8, FI_INT16, FI_UINT16, FI_INT32, FI_UINT32, FI_INT64, FI_UINT64, FI_FLOAT, FI_DOUBLE, FI_FLOAT_COMPLEX, FI_DOUBLE_COMPLEX, FI_LONG_DOUBLE, FI_LONG_DOUBLE_COMPLEX, FI_DATATYPE_LAST }; enum fi_op { FI_MIN, FI_MAX, FI_SUM, FI_PROD, FI_LOR, FI_LAND, FI_BOR, FI_BAND, FI_LXOR, FI_BXOR, FI_ATOMIC_READ, FI_ATOMIC_WRITE, FI_CSWAP, FI_CSWAP_NE, FI_CSWAP_LE, FI_CSWAP_LT, FI_CSWAP_GE, FI_CSWAP_GT, FI_MSWAP, FI_ATOMIC_OP_LAST }; #endif struct fi_atomic_attr; struct fi_cq_attr; struct fi_cntr_attr; struct fi_ops_domain { size_t size; int (*av_open)(struct fid_domain *domain, struct fi_av_attr *attr, struct fid_av **av, void *context); int (*cq_open)(struct fid_domain *domain, struct fi_cq_attr *attr, struct fid_cq **cq, void *context); int (*endpoint)(struct fid_domain *domain, struct fi_info *info, struct fid_ep **ep, void *context); int (*scalable_ep)(struct fid_domain *domain, struct fi_info *info, struct fid_ep **sep, void *context); int (*cntr_open)(struct fid_domain *domain, struct fi_cntr_attr *attr, struct fid_cntr **cntr, void *context); int (*poll_open)(struct fid_domain *domain, struct fi_poll_attr *attr, struct fid_poll **pollset); int (*stx_ctx)(struct fid_domain *domain, struct fi_tx_attr *attr, struct fid_stx **stx, void *context); int (*srx_ctx)(struct fid_domain *domain, struct fi_rx_attr *attr, struct fid_ep **rx_ep, void *context); int (*query_atomic)(struct fid_domain *domain, enum fi_datatype datatype, enum fi_op op, struct fi_atomic_attr *attr, uint64_t flags); }; /* Memory registration flags */ /* #define FI_RMA_EVENT (1ULL << 56) */ struct fi_ops_mr { size_t size; int (*reg)(struct fid *fid, const void *buf, size_t len, uint64_t access, uint64_t offset, uint64_t requested_key, uint64_t flags, struct fid_mr **mr, void *context); int (*regv)(struct fid *fid, const struct iovec *iov, size_t count, uint64_t access, uint64_t offset, uint64_t requested_key, uint64_t flags, struct fid_mr **mr, void *context); int (*regattr)(struct fid *fid, const struct fi_mr_attr *attr, uint64_t flags, struct fid_mr **mr); }; /* Domain bind flags */ #define FI_REG_MR (1ULL << 59) struct fid_domain { struct fid fid; struct fi_ops_domain *ops; struct fi_ops_mr *mr; }; #ifdef FABRIC_DIRECT #include #endif /* FABRIC_DIRECT */ #ifndef FABRIC_DIRECT_DOMAIN static inline int fi_domain(struct fid_fabric *fabric, struct fi_info *info, struct fid_domain **domain, void *context) { return fabric->ops->domain(fabric, info, domain, context); } static inline int fi_domain_bind(struct fid_domain *domain, struct fid *fid, uint64_t flags) { return domain->fid.ops->bind(&domain->fid, fid, flags); } static inline int fi_cq_open(struct fid_domain *domain, struct fi_cq_attr *attr, struct fid_cq **cq, void *context) { return domain->ops->cq_open(domain, attr, cq, context); } static inline int fi_cntr_open(struct fid_domain *domain, struct fi_cntr_attr *attr, struct fid_cntr **cntr, void *context) { return domain->ops->cntr_open(domain, attr, cntr, context); } static inline int fi_wait_open(struct fid_fabric *fabric, struct fi_wait_attr *attr, struct fid_wait **waitset) { return fabric->ops->wait_open(fabric, attr, waitset); } static inline int fi_poll_open(struct fid_domain *domain, struct fi_poll_attr *attr, struct fid_poll **pollset) { return domain->ops->poll_open(domain, attr, pollset); } static inline int fi_mr_reg(struct fid_domain *domain, const void *buf, size_t len, uint64_t access, uint64_t offset, uint64_t requested_key, uint64_t flags, struct fid_mr **mr, void *context) { return domain->mr->reg(&domain->fid, buf, len, access, offset, requested_key, flags, mr, context); } static inline int fi_mr_regv(struct fid_domain *domain, const struct iovec *iov, size_t count, uint64_t access, uint64_t offset, uint64_t requested_key, uint64_t flags, struct fid_mr **mr, void *context) { return domain->mr->regv(&domain->fid, iov, count, access, offset, requested_key, flags, mr, context); } static inline int fi_mr_regattr(struct fid_domain *domain, const struct fi_mr_attr *attr, uint64_t flags, struct fid_mr **mr) { return domain->mr->regattr(&domain->fid, attr, flags, mr); } static inline void *fi_mr_desc(struct fid_mr *mr) { return mr->mem_desc; } static inline uint64_t fi_mr_key(struct fid_mr *mr) { return mr->key; } static inline int fi_mr_raw_attr(struct fid_mr *mr, uint64_t *base_addr, uint8_t *raw_key, size_t *key_size, uint64_t flags) { struct fi_mr_raw_attr attr = { .flags = flags, .base_addr = base_addr, .raw_key = raw_key, .key_size = key_size }; return mr->fid.ops->control(&mr->fid, FI_GET_RAW_MR, &attr); } static inline int fi_mr_map_raw(struct fid_domain *domain, uint64_t base_addr, uint8_t *raw_key, size_t key_size, uint64_t *key, uint64_t flags) { struct fi_mr_map_raw map = { .flags = flags, .base_addr = base_addr, .raw_key = raw_key, .key_size = key_size, .key = key }; return domain->fid.ops->control(&domain->fid, FI_MAP_RAW_MR, &map); } static inline int fi_mr_unmap_key(struct fid_domain *domain, uint64_t key) { return domain->fid.ops->control(&domain->fid, FI_UNMAP_KEY, &key); } static inline int fi_mr_bind(struct fid_mr *mr, struct fid *bfid, uint64_t flags) { return mr->fid.ops->bind(&mr->fid, bfid, flags); } static inline int fi_mr_refresh(struct fid_mr *mr, const struct iovec *iov, size_t count, uint64_t flags) { struct fi_mr_modify modify = {0}; modify.flags = flags; modify.attr.mr_iov = iov; modify.attr.iov_count = count; return mr->fid.ops->control(&mr->fid, FI_REFRESH, &modify); } static inline int fi_mr_enable(struct fid_mr *mr) { return mr->fid.ops->control(&mr->fid, FI_ENABLE, NULL); } static inline int fi_av_open(struct fid_domain *domain, struct fi_av_attr *attr, struct fid_av **av, void *context) { return domain->ops->av_open(domain, attr, av, context); } static inline int fi_av_bind(struct fid_av *av, struct fid *fid, uint64_t flags) { return av->fid.ops->bind(&av->fid, fid, flags); } static inline int fi_av_insert(struct fid_av *av, const void *addr, size_t count, fi_addr_t *fi_addr, uint64_t flags, void *context) { return av->ops->insert(av, addr, count, fi_addr, flags, context); } static inline int fi_av_insertsvc(struct fid_av *av, const char *node, const char *service, fi_addr_t *fi_addr, uint64_t flags, void *context) { return av->ops->insertsvc(av, node, service, fi_addr, flags, context); } static inline int fi_av_insertsym(struct fid_av *av, const char *node, size_t nodecnt, const char *service, size_t svccnt, fi_addr_t *fi_addr, uint64_t flags, void *context) { return av->ops->insertsym(av, node, nodecnt, service, svccnt, fi_addr, flags, context); } static inline int fi_av_remove(struct fid_av *av, fi_addr_t *fi_addr, size_t count, uint64_t flags) { return av->ops->remove(av, fi_addr, count, flags); } static inline int fi_av_lookup(struct fid_av *av, fi_addr_t fi_addr, void *addr, size_t *addrlen) { return av->ops->lookup(av, fi_addr, addr, addrlen); } static inline const char * fi_av_straddr(struct fid_av *av, const void *addr, char *buf, size_t *len) { return av->ops->straddr(av, addr, buf, len); } static inline fi_addr_t fi_rx_addr(fi_addr_t fi_addr, int rx_index, int rx_ctx_bits) { return (fi_addr_t) (((uint64_t) rx_index << (64 - rx_ctx_bits)) | fi_addr); } #endif #ifdef __cplusplus } #endif #endif /* FI_DOMAIN_H */