xref: /freebsd/sys/dev/ice/ice_rdma.c (revision d0b2dbfa0ecf2bbc9709efc5e20baf8e4b44bbbf)

/* SPDX-License-Identifier: BSD-3-Clause */
/*  Copyright (c) 2023, Intel Corporation
 *  All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright notice,
 *      this list of conditions and the following disclaimer.
 *
 *   2. 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.
 *
 *   3. Neither the name of the 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.
 */

/**
 * @file ice_rdma.c
 * @brief RDMA client driver interface
 *
 * Functions to interface with the RDMA client driver, for enabling RMDA
 * functionality for the ice driver.
 *
 * The RDMA client interface is based on a simple kobject interface which is
 * defined by the rmda_if.m and irdma_di_if.m interfaces.
 *
 * The ice device driver provides the rmda_di_if.m interface methods, while
 * the client RDMA driver provides the irdma_if.m interface methods as an
 * extension ontop of the irdma_di_if kobject.
 *
 * The initial connection between drivers is done via the RDMA client driver
 * calling ice_rdma_register.
 */

#include "ice_iflib.h"
#include "ice_rdma_internal.h"

#include "irdma_if.h"
#include "irdma_di_if.h"

/**
 * @var ice_rdma
 * @brief global RDMA driver state
 *
 * Contains global state the driver uses to connect to a client RDMA interface
 * driver.
 */
static struct ice_rdma_state ice_rdma;

/*
 * Helper function prototypes
 */
static int ice_rdma_pf_attach_locked(struct ice_softc *sc);
static void ice_rdma_pf_detach_locked(struct ice_softc *sc);
static int ice_rdma_check_version(struct ice_rdma_info *info);
static void ice_rdma_cp_qos_info(struct ice_hw *hw,
				 struct ice_dcbx_cfg *dcbx_cfg,
				 struct ice_qos_params *qos_info);

/*
 * RDMA Device Interface prototypes
 */
static int ice_rdma_pf_reset(struct ice_rdma_peer *peer);
static int ice_rdma_pf_msix_init(struct ice_rdma_peer *peer,
				 struct ice_rdma_msix_mapping *msix_info);
static int ice_rdma_qset_register_request(struct ice_rdma_peer *peer,
			     struct ice_rdma_qset_update *res);
static int ice_rdma_update_vsi_filter(struct ice_rdma_peer *peer_dev,
				      bool enable);
static void ice_rdma_request_handler(struct ice_rdma_peer *peer,
				     struct ice_rdma_request *req);


/**
 * @var ice_rdma_di_methods
 * @brief RDMA driver interface methods
 *
 * Kobject methods implementing the driver-side interface for the RDMA peer
 * clients. This method table contains the operations which the client can
 * request from the driver.
 *
 * The client driver will then extend this kobject class with methods that the
 * driver can request from the client.
 */
static kobj_method_t ice_rdma_di_methods[] = {
	KOBJMETHOD(irdma_di_reset, ice_rdma_pf_reset),
	KOBJMETHOD(irdma_di_msix_init, ice_rdma_pf_msix_init),
	KOBJMETHOD(irdma_di_qset_register_request, ice_rdma_qset_register_request),
	KOBJMETHOD(irdma_di_vsi_filter_update, ice_rdma_update_vsi_filter),
	KOBJMETHOD(irdma_di_req_handler, ice_rdma_request_handler),
	KOBJMETHOD_END
};

/* Define ice_rdma_di class which will be extended by the iRDMA driver */
DEFINE_CLASS_0(ice_rdma_di, ice_rdma_di_class, ice_rdma_di_methods, sizeof(struct ice_rdma_peer));

/**
 * ice_rdma_pf_reset - RDMA client interface requested a reset
 * @peer: the RDMA peer client structure
 *
 * Implements IRDMA_DI_RESET, called by the RDMA client driver to request
 * a reset of an ice driver device.
 */
static int
ice_rdma_pf_reset(struct ice_rdma_peer *peer)
{
	struct ice_softc *sc = ice_rdma_peer_to_sc(peer);

	/*
	 * Request that the driver re-initialize by bringing the interface
	 * down and up.
	 */
	ice_request_stack_reinit(sc);

	return (0);
}

/**
 * ice_rdma_pf_msix_init - RDMA client interface request MSI-X initialization
 * @peer: the RDMA peer client structure
 * @msix_info: requested MSI-X mapping
 *
 * Implements IRDMA_DI_MSIX_INIT, called by the RDMA client driver to
 * initialize the MSI-X resources required for RDMA functionality.
 */
static int
ice_rdma_pf_msix_init(struct ice_rdma_peer *peer,
		      struct ice_rdma_msix_mapping __unused *msix_info)
{
	struct ice_softc *sc = ice_rdma_peer_to_sc(peer);

	MPASS(msix_info != NULL);

	device_printf(sc->dev, "%s: iRDMA MSI-X initialization request is not yet implemented\n", __func__);

	/* TODO: implement MSI-X initialization for RDMA */
	return (ENOSYS);
}

/**
 * ice_rdma_register_request - RDMA client interface request qset
 *                             registration or unregistration
 * @peer: the RDMA peer client structure
 * @res: resources to be registered or unregistered
 */
static int
ice_rdma_qset_register_request(struct ice_rdma_peer *peer, struct ice_rdma_qset_update *res)
{
	struct ice_softc *sc = ice_rdma_peer_to_sc(peer);
	struct ice_vsi *vsi = NULL;
	struct ice_dcbx_cfg *dcbx_cfg;
	struct ice_hw *hw = &sc->hw;
	enum ice_status status;
	int count, i, ret = 0;
	uint32_t *qset_teid;
	uint16_t *qs_handle;
	uint16_t max_rdmaqs[ICE_MAX_TRAFFIC_CLASS];
	uint16_t vsi_id;
	uint8_t ena_tc = 0;

	if (!res)
		return -EINVAL;

	if (res->cnt_req > ICE_MAX_TXQ_PER_TXQG)
		return -EINVAL;

	switch(res->res_type) {
	case ICE_RDMA_QSET_ALLOC:
		count = res->cnt_req;
		vsi_id = peer->pf_vsi_num;
		break;
	case ICE_RDMA_QSET_FREE:
		count = res->res_allocated;
		vsi_id = res->qsets.vsi_id;
		break;
	default:
		return -EINVAL;
	}
	qset_teid = (uint32_t *)ice_calloc(hw, count, sizeof(*qset_teid));
	if (!qset_teid)
		return -ENOMEM;

	qs_handle = (uint16_t *)ice_calloc(hw, count, sizeof(*qs_handle));
	if (!qs_handle) {
		ice_free(hw, qset_teid);
		return -ENOMEM;
	}

	ice_for_each_traffic_class(i)
		max_rdmaqs[i] = 0;
	for (i = 0; i < sc->num_available_vsi; i++) {
		if (sc->all_vsi[i] &&
		    ice_get_hw_vsi_num(hw, sc->all_vsi[i]->idx) == vsi_id) {
			vsi = sc->all_vsi[i];
			break;
		}
	}

	if (!vsi) {
		ice_debug(hw, ICE_DBG_RDMA, "RDMA QSet invalid VSI\n");
		ret = -EINVAL;
		goto out;
	}
	if (sc != vsi->sc) {
		ice_debug(hw, ICE_DBG_RDMA, "VSI is tied to unexpected device\n");
		ret = -EXDEV;
		goto out;
	}

	for (i = 0; i < count; i++) {
		struct ice_rdma_qset_params *qset;

		qset = &res->qsets;
		if (qset->vsi_id != peer->pf_vsi_num) {
			ice_debug(hw, ICE_DBG_RDMA, "RDMA QSet invalid VSI requested %d %d\n",
				  qset->vsi_id, peer->pf_vsi_num);
			ret = -EINVAL;
			goto out;
		}
		max_rdmaqs[qset->tc]++;
		qs_handle[i] = qset->qs_handle;
		qset_teid[i] = qset->teid;
	}

	switch(res->res_type) {
	case ICE_RDMA_QSET_ALLOC:
		dcbx_cfg = &hw->port_info->qos_cfg.local_dcbx_cfg;
		ena_tc = ice_dcb_get_tc_map(dcbx_cfg);

		ice_debug(hw, ICE_DBG_RDMA, "%s:%d ena_tc=%x\n", __func__, __LINE__, ena_tc);
		status = ice_cfg_vsi_rdma(hw->port_info, vsi->idx, ena_tc,
					  max_rdmaqs);
		if (status) {
			ice_debug(hw, ICE_DBG_RDMA, "Failed VSI RDMA qset config\n");
			ret = -EINVAL;
			goto out;
		}

		for (i = 0; i < count; i++) {
			struct ice_rdma_qset_params *qset;

			qset = &res->qsets;
			status = ice_ena_vsi_rdma_qset(hw->port_info, vsi->idx,
						       qset->tc, &qs_handle[i], 1,
						       &qset_teid[i]);
			if (status) {
				ice_debug(hw, ICE_DBG_RDMA, "Failed VSI RDMA qset enable\n");
				ret = -EINVAL;
				goto out;
			}
			qset->teid = qset_teid[i];
		}
		break;
	case ICE_RDMA_QSET_FREE:
		status = ice_dis_vsi_rdma_qset(hw->port_info, count, qset_teid, qs_handle);
		if (status)
			ret = -EINVAL;
		break;
	default:
		ret = -EINVAL;
		break;
	}

out:
	ice_free(hw, qs_handle);
	ice_free(hw, qset_teid);

	return ret;
}

/**
 *  ice_rdma_update_vsi_filter - configure vsi information
 *                               when opening or closing rdma driver
 *  @peer: the RDMA peer client structure
 *  @enable: enable or disable the rdma filter
 */
static int
ice_rdma_update_vsi_filter(struct ice_rdma_peer *peer,
			   bool enable)
{
	struct ice_softc *sc = ice_rdma_peer_to_sc(peer);
	struct ice_vsi *vsi;
	int ret;

	vsi = &sc->pf_vsi;
	if (!vsi)
		return -EINVAL;

	ret = ice_cfg_iwarp_fltr(&sc->hw, vsi->idx, enable);
	if (ret) {
		device_printf(sc->dev, "Failed to  %sable iWARP filtering\n",
				enable ? "en" : "dis");
	} else {
		if (enable)
			vsi->info.q_opt_flags |= ICE_AQ_VSI_Q_OPT_PE_FLTR_EN;
		else
			vsi->info.q_opt_flags &= ~ICE_AQ_VSI_Q_OPT_PE_FLTR_EN;
	}

	return ret;
}

/**
 * ice_rdma_request_handler - handle requests incoming from RDMA driver
 * @peer: the RDMA peer client structure
 * @req: structure containing request
 */
static void
ice_rdma_request_handler(struct ice_rdma_peer *peer,
			 struct ice_rdma_request *req)
{
	if (!req || !peer) {
		log(LOG_WARNING, "%s: peer or req are not valid\n", __func__);
		return;
	}

	switch(req->type) {
	case ICE_RDMA_EVENT_RESET:
		break;
	case ICE_RDMA_EVENT_QSET_REGISTER:
		ice_rdma_qset_register_request(peer, &req->res);
		break;
	case ICE_RDMA_EVENT_VSI_FILTER_UPDATE:
		ice_rdma_update_vsi_filter(peer, req->enable_filter);
		break;
	default:
		log(LOG_WARNING, "%s: Event %d not supported\n", __func__, req->type);
		break;
	}
}

/**
 * ice_rdma_cp_qos_info - gather current QOS/DCB settings in LAN to pass
 *                        to RDMA driver
 * @hw: ice hw structure
 * @dcbx_cfg: current DCB settings in ice driver
 * @qos_info: destination of the DCB settings
 */
static void
ice_rdma_cp_qos_info(struct ice_hw *hw, struct ice_dcbx_cfg *dcbx_cfg,
		     struct ice_qos_params *qos_info)
{
	u32 up2tc;
	u8 j;
	u8 num_tc = 0;
	u8 val_tc = 0;  /* number of TC for validation */
	u8 cnt_tc = 0;

	/* setup qos_info fields with defaults */
	qos_info->num_apps = 0;
	qos_info->num_tc = 1;

	for (j = 0; j < ICE_TC_MAX_USER_PRIORITY; j++)
		qos_info->up2tc[j] = 0;

	qos_info->tc_info[0].rel_bw = 100;
	for (j = 1; j < IEEE_8021QAZ_MAX_TCS; j++)
		qos_info->tc_info[j].rel_bw = 0;

	/* gather current values */
	up2tc = rd32(hw, PRTDCB_TUP2TC);
	qos_info->num_apps = dcbx_cfg->numapps;

	for (j = 0; j < ICE_MAX_TRAFFIC_CLASS; j++) {
		num_tc |= BIT(dcbx_cfg->etscfg.prio_table[j]);
	}
	for (j = 0; j < ICE_MAX_TRAFFIC_CLASS; j++) {
		if (num_tc & BIT(j)) {
			cnt_tc++;
			val_tc |= BIT(j);
		} else {
			break;
		}
	}
	qos_info->num_tc = (val_tc == num_tc && num_tc != 0) ? cnt_tc : 1;
	for (j = 0; j < ICE_TC_MAX_USER_PRIORITY; j++)
		qos_info->up2tc[j] = (up2tc >> (j * 3)) & 0x7;

	for (j = 0; j < IEEE_8021QAZ_MAX_TCS; j++)
		qos_info->tc_info[j].rel_bw = dcbx_cfg->etscfg.tcbwtable[j];
	for (j = 0; j < qos_info->num_apps; j++) {
		qos_info->apps[j].priority = dcbx_cfg->app[j].priority;
		qos_info->apps[j].prot_id = dcbx_cfg->app[j].prot_id;
		qos_info->apps[j].selector = dcbx_cfg->app[j].selector;
	}

	/* Gather DSCP-to-TC mapping and QoS/PFC mode */
	memcpy(qos_info->dscp_map, dcbx_cfg->dscp_map, sizeof(qos_info->dscp_map));
	qos_info->pfc_mode = dcbx_cfg->pfc_mode;
}

/**
 * ice_rdma_check_version - Check that the provided RDMA version is compatible
 * @info: the RDMA client information structure
 *
 * Verify that the client RDMA driver provided a version that is compatible
 * with the driver interface.
 */
static int
ice_rdma_check_version(struct ice_rdma_info *info)
{
	/* Make sure the MAJOR version matches */
	if (info->major_version != ICE_RDMA_MAJOR_VERSION) {
		log(LOG_WARNING, "%s: the iRDMA driver requested version %d.%d.%d, but this driver only supports major version %d.x.x\n",
		    __func__,
		    info->major_version, info->minor_version, info->patch_version,
		    ICE_RDMA_MAJOR_VERSION);
		return (ENOTSUP);
	}

	/*
	 * Make sure that the MINOR version is compatible.
	 *
	 * This means that the RDMA client driver version MUST not be greater
	 * than the version provided by the driver, as it would indicate that
	 * the RDMA client expects features which are not supported by the
	 * main driver.
	 */
	if (info->minor_version > ICE_RDMA_MINOR_VERSION) {
		log(LOG_WARNING, "%s: the iRDMA driver requested version %d.%d.%d, but this driver only supports up to minor version %d.%d.x\n",
		__func__,
		info->major_version, info->minor_version, info->patch_version,
		ICE_RDMA_MAJOR_VERSION, ICE_RDMA_MINOR_VERSION);
		return (ENOTSUP);
	}

	/*
	 * Make sure that the PATCH version is compatible.
	 *
	 * This means that the RDMA client version MUST not be greater than
	 * the version provided by the driver, as it may indicate that the
	 * RDMA client expects certain backwards compatible bug fixes which
	 * are not implemented by this version of the main driver.
	 */
	if ((info->minor_version == ICE_RDMA_MINOR_VERSION) &&
	    (info->patch_version > ICE_RDMA_PATCH_VERSION)) {
		log(LOG_WARNING, "%s: the iRDMA driver requested version %d.%d.%d, but this driver only supports up to patch version %d.%d.%d\n",
		__func__,
		info->major_version, info->minor_version, info->patch_version,
		ICE_RDMA_MAJOR_VERSION, ICE_RDMA_MINOR_VERSION, ICE_RDMA_PATCH_VERSION);
		return (ENOTSUP);
	}

	/* Make sure that the kobject class is initialized */
	if (info->rdma_class == NULL) {
		log(LOG_WARNING, "%s: the iRDMA driver did not specify a kobject interface\n",
		    __func__);
		return (EINVAL);
	}

	return (0);
}

/**
 * ice_rdma_register - Register an RDMA client driver
 * @info: the RDMA client information structure
 *
 * Called by the RDMA client driver on load. Used to initialize the RDMA
 * client driver interface and enable interop between the ice driver and the
 * RDMA client driver.
 *
 * The RDMA client driver must provide the version number it expects, along
 * with a pointer to a kobject class that extends the irdma_di_if class, and
 * implements the irdma_if class interface.
 */
int
ice_rdma_register(struct ice_rdma_info *info)
{
	struct ice_rdma_entry *entry;
	struct ice_softc *sc;
	int err = 0;

	sx_xlock(&ice_rdma.mtx);

	if (!ice_enable_irdma) {
		log(LOG_INFO, "%s: The iRDMA driver interface has been disabled\n", __func__);
		err = (ECONNREFUSED);
		goto return_unlock;
	}

	if (ice_rdma.registered) {
		log(LOG_WARNING, "%s: iRDMA driver already registered\n", __func__);
		err = (EBUSY);
		goto return_unlock;
	}

	/* Make sure the iRDMA version is compatible */
	err = ice_rdma_check_version(info);
	if (err)
		goto return_unlock;

	log(LOG_INFO, "%s: iRDMA driver registered using version %d.%d.%d\n",
	    __func__, info->major_version, info->minor_version, info->patch_version);

	ice_rdma.peer_class = info->rdma_class;

	/*
	 * Initialize the kobject interface and notify the RDMA client of each
	 * existing PF interface.
	 */
	LIST_FOREACH(entry, &ice_rdma.peers, node) {
		kobj_init((kobj_t)&entry->peer, ice_rdma.peer_class);
		/* Gather DCB/QOS info into peer */
		sc = __containerof(entry, struct ice_softc, rdma_entry);
		memset(&entry->peer.initial_qos_info, 0, sizeof(entry->peer.initial_qos_info));
		ice_rdma_cp_qos_info(&sc->hw, &sc->hw.port_info->qos_cfg.local_dcbx_cfg,
				     &entry->peer.initial_qos_info);

		IRDMA_PROBE(&entry->peer);
		if (entry->initiated)
			IRDMA_OPEN(&entry->peer);
	}
	ice_rdma.registered = true;

return_unlock:
	sx_xunlock(&ice_rdma.mtx);

	return (err);
}

/**
 * ice_rdma_unregister - Unregister an RDMA client driver
 *
 * Called by the RDMA client driver on unload. Used to de-initialize the RDMA
 * client driver interface and shut down communication between the ice driver
 * and the RDMA client driver.
 */
int
ice_rdma_unregister(void)
{
	struct ice_rdma_entry *entry;

	sx_xlock(&ice_rdma.mtx);

	if (!ice_rdma.registered) {
		log(LOG_WARNING, "%s: iRDMA driver was not previously registered\n",
		       __func__);
		sx_xunlock(&ice_rdma.mtx);
		return (ENOENT);
	}

	log(LOG_INFO, "%s: iRDMA driver unregistered\n", __func__);
	ice_rdma.registered = false;
	ice_rdma.peer_class = NULL;

	/*
	 * Release the kobject interface for each of the existing PF
	 * interfaces. Note that we do not notify the client about removing
	 * each PF, as it is assumed that the client will have already cleaned
	 * up any associated resources when it is unregistered.
	 */
	LIST_FOREACH(entry, &ice_rdma.peers, node)
		kobj_delete((kobj_t)&entry->peer, NULL);

	sx_xunlock(&ice_rdma.mtx);

	return (0);
}

/**
 * ice_rdma_init - RDMA driver init routine
 *
 * Called during ice driver module initialization to setup the RDMA client
 * interface mutex and RDMA peer structure list.
 */
void
ice_rdma_init(void)
{
	LIST_INIT(&ice_rdma.peers);
	sx_init_flags(&ice_rdma.mtx, "ice rdma interface", SX_DUPOK);

	ice_rdma.registered = false;
	ice_rdma.peer_class = NULL;
}

/**
 * ice_rdma_exit - RDMA driver exit routine
 *
 * Called during ice driver module exit to shutdown the RDMA client interface
 * mutex.
 */
void
ice_rdma_exit(void)
{
	MPASS(LIST_EMPTY(&ice_rdma.peers));
	sx_destroy(&ice_rdma.mtx);
}

/**
 * ice_rdma_pf_attach_locked - Prepare a PF for RDMA connections
 * @sc: the ice driver softc
 *
 * Initialize a peer entry for this PF and add it to the RDMA interface list.
 * Notify the client RDMA driver of a new PF device.
 *
 * @pre must be called while holding the ice_rdma mutex.
 */
static int
ice_rdma_pf_attach_locked(struct ice_softc *sc)
{
	struct ice_rdma_entry *entry;

	/* Do not attach the PF unless RDMA is supported */
	if (!ice_is_bit_set(sc->feat_cap, ICE_FEATURE_RDMA))
		return (0);

	entry = &sc->rdma_entry;
	if (entry->attached) {
		device_printf(sc->dev, "iRDMA peer entry already exists\n");
		return (EEXIST);
	}

	entry->attached = true;
	entry->peer.dev = sc->dev;
	entry->peer.ifp = sc->ifp;
	entry->peer.pf_id = sc->hw.pf_id;
	entry->peer.pci_mem = sc->bar0.res;
	entry->peer.pf_vsi_num = ice_get_hw_vsi_num(&sc->hw, sc->pf_vsi.idx);
	if (sc->rdma_imap && sc->rdma_imap[0] != ICE_INVALID_RES_IDX &&
	    sc->irdma_vectors > 0) {
		entry->peer.msix.base = sc->rdma_imap[0];
		entry->peer.msix.count = sc->irdma_vectors;
	}

	/* Gather DCB/QOS info into peer */
	memset(&entry->peer.initial_qos_info, 0, sizeof(entry->peer.initial_qos_info));
	ice_rdma_cp_qos_info(&sc->hw, &sc->hw.port_info->qos_cfg.local_dcbx_cfg,
			     &entry->peer.initial_qos_info);

	/*
	 * If the RDMA client driver has already registered, initialize the
	 * kobject and notify the client of a new PF
	 */
	if (ice_rdma.registered) {
		kobj_init((kobj_t)&entry->peer, ice_rdma.peer_class);
		IRDMA_PROBE(&entry->peer);
	}

	LIST_INSERT_HEAD(&ice_rdma.peers, entry, node);

	ice_set_bit(ICE_FEATURE_RDMA, sc->feat_en);

	return (0);
}

/**
 * ice_rdma_pf_attach - Notify the RDMA client of a new PF
 * @sc: the ice driver softc
 *
 * Called during PF attach to notify the RDMA client of a new PF.
 */
int
ice_rdma_pf_attach(struct ice_softc *sc)
{
	int err;

	sx_xlock(&ice_rdma.mtx);
	err = ice_rdma_pf_attach_locked(sc);
	sx_xunlock(&ice_rdma.mtx);

	return (err);
}

/**
 * ice_rdma_pf_detach_locked - Notify the RDMA client on PF detach
 * @sc: the ice driver softc
 *
 * Notify the RDMA peer client driver of removal of a PF, and release any
 * RDMA-specific resources associated with that PF. Remove the PF from the
 * list of available RDMA entries.
 *
 * @pre must be called while holding the ice_rdma mutex.
 */
static void
ice_rdma_pf_detach_locked(struct ice_softc *sc)
{
	struct ice_rdma_entry *entry;

	/* No need to detach the PF if RDMA is not enabled */
	if (!ice_is_bit_set(sc->feat_en, ICE_FEATURE_RDMA))
		return;

	entry = &sc->rdma_entry;
	if (!entry->attached) {
		device_printf(sc->dev, "iRDMA peer entry was not attached\n");
		return;
	}

	/*
	 * If the RDMA client driver is registered, notify the client that
	 * a PF has been removed, and release the kobject reference.
	 */
	if (ice_rdma.registered) {
		IRDMA_REMOVE(&entry->peer);
		kobj_delete((kobj_t)&entry->peer, NULL);
	}

	LIST_REMOVE(entry, node);
	entry->attached = false;

	ice_clear_bit(ICE_FEATURE_RDMA, sc->feat_en);
}

/**
 * ice_rdma_pf_detach - Notify the RDMA client of a PF detaching
 * @sc: the ice driver softc
 *
 * Take the ice_rdma mutex and then notify the RDMA client that a PF has been
 * removed.
 */
void
ice_rdma_pf_detach(struct ice_softc *sc)
{
	sx_xlock(&ice_rdma.mtx);
	ice_rdma_pf_detach_locked(sc);
	sx_xunlock(&ice_rdma.mtx);
}

/**
 * ice_rdma_pf_init - Notify the RDMA client that a PF has initialized
 * @sc: the ice driver softc
 *
 * Called by the ice driver when a PF has been initialized. Notifies the RDMA
 * client that a PF is up and ready to operate.
 */
int
ice_rdma_pf_init(struct ice_softc *sc)
{
	struct ice_rdma_peer *peer = &sc->rdma_entry.peer;

	sx_xlock(&ice_rdma.mtx);

	/* Update the MTU */
	peer->mtu = if_getmtu(sc->ifp);
	sc->rdma_entry.initiated = true;

	if (sc->rdma_entry.attached && ice_rdma.registered) {
		sx_xunlock(&ice_rdma.mtx);
		return IRDMA_OPEN(peer);
	}

	sx_xunlock(&ice_rdma.mtx);

	return (0);
}

/**
 * ice_rdma_pf_stop - Notify the RDMA client of a stopped PF device
 * @sc: the ice driver softc
 *
 * Called by the ice driver when a PF is stopped. Notifies the RDMA client
 * driver that the PF has stopped and is not ready to operate.
 */
int
ice_rdma_pf_stop(struct ice_softc *sc)
{
	sx_xlock(&ice_rdma.mtx);

	sc->rdma_entry.initiated = false;
	if (sc->rdma_entry.attached && ice_rdma.registered) {
		sx_xunlock(&ice_rdma.mtx);
		return IRDMA_CLOSE(&sc->rdma_entry.peer);
	}

	sx_xunlock(&ice_rdma.mtx);

	return (0);
}

/**
 * ice_rdma_link_change - Notify RDMA client of a change in link status
 * @sc: the ice driver softc
 * @linkstate: the link status
 * @baudrate: the link rate in bits per second
 *
 * Notify the RDMA client of a link status change, by sending it the new link
 * state and baudrate.
 *
 * The link state is represented the same was as in the ifnet structure. It
 * should be LINK_STATE_UNKNOWN, LINK_STATE_DOWN, or LINK_STATE_UP.
 */
void
ice_rdma_link_change(struct ice_softc *sc, int linkstate, uint64_t baudrate)
{
	struct ice_rdma_peer *peer = &sc->rdma_entry.peer;
	struct ice_rdma_event event;

	memset(&event, 0, sizeof(struct ice_rdma_event));
	event.type = ICE_RDMA_EVENT_LINK_CHANGE;
	event.linkstate = linkstate;
	event.baudrate = baudrate;

	sx_xlock(&ice_rdma.mtx);

	if (sc->rdma_entry.attached && ice_rdma.registered)
		IRDMA_EVENT_HANDLER(peer, &event);

	sx_xunlock(&ice_rdma.mtx);
}

/**
 *  ice_rdma_notify_dcb_qos_change - notify RDMA driver to pause traffic
 *  @sc: the ice driver softc
 *
 *  Notify the RDMA driver that QOS/DCB settings are about to change.
 *  Once the function return, all the QPs should be suspended.
 */
void
ice_rdma_notify_dcb_qos_change(struct ice_softc *sc)
{
	struct ice_rdma_peer *peer = &sc->rdma_entry.peer;
	struct ice_rdma_event event;

	memset(&event, 0, sizeof(struct ice_rdma_event));
	event.type = ICE_RDMA_EVENT_TC_CHANGE;
	/* pre-event */
	event.prep = true;

	sx_xlock(&ice_rdma.mtx);
	if (sc->rdma_entry.attached && ice_rdma.registered)
		IRDMA_EVENT_HANDLER(peer, &event);
	sx_xunlock(&ice_rdma.mtx);
}

/**
 *  ice_rdma_dcb_qos_update - pass the changed dcb settings to RDMA driver
 *  @sc: the ice driver softc
 *  @pi: the port info structure
 *
 *  Pass the changed DCB settings to RDMA traffic. This function should be
 *  called only after ice_rdma_notify_dcb_qos_change has been called and
 *  returned before. After the function returns, all the RDMA traffic
 *  should be resumed.
 */
void
ice_rdma_dcb_qos_update(struct ice_softc *sc, struct ice_port_info *pi)
{
	struct ice_rdma_peer *peer = &sc->rdma_entry.peer;
	struct ice_rdma_event event;

	memset(&event, 0, sizeof(struct ice_rdma_event));
	event.type = ICE_RDMA_EVENT_TC_CHANGE;
	/* post-event */
	event.prep = false;

	/* gather current configuration */
	ice_rdma_cp_qos_info(&sc->hw, &pi->qos_cfg.local_dcbx_cfg, &event.port_qos);
	sx_xlock(&ice_rdma.mtx);
	if (sc->rdma_entry.attached && ice_rdma.registered)
		IRDMA_EVENT_HANDLER(peer, &event);
	sx_xunlock(&ice_rdma.mtx);
}