/* SPDX-License-Identifier: MIT */ /* * Copyright © 2023-2024 Intel Corporation */ #ifndef _XE_SRIOV_PF_HELPERS_H_ #define _XE_SRIOV_PF_HELPERS_H_ #include "xe_assert.h" #include "xe_device_types.h" #include "xe_sriov.h" #include "xe_sriov_types.h" /** * xe_sriov_pf_assert_vfid() - warn if &id is not a supported VF number when debugging. * @xe: the PF &xe_device to assert on * @vfid: the VF number to assert * * Assert that &xe represents the Physical Function (PF) device and provided &vfid * is within a range of supported VF numbers (up to maximum number of VFs that * driver can support, including VF0 that represents the PF itself). * * Note: Effective only on debug builds. See `Xe Asserts`_ for more information. */ #define xe_sriov_pf_assert_vfid(xe, vfid) \ xe_assert((xe), (vfid) <= xe_sriov_pf_get_totalvfs(xe)) /** * xe_sriov_pf_get_totalvfs() - Get maximum number of VFs that driver can support. * @xe: the &xe_device to query (shall be PF) * * Return: Maximum number of VFs that this PF driver supports. */ static inline int xe_sriov_pf_get_totalvfs(struct xe_device *xe) { xe_assert(xe, IS_SRIOV_PF(xe)); return xe->sriov.pf.driver_max_vfs; } /** * xe_sriov_pf_num_vfs() - Number of enabled VFs on the PF. * @xe: the PF &xe_device * * Return: Number of enabled VFs on the PF. */ static inline unsigned int xe_sriov_pf_num_vfs(const struct xe_device *xe) { return pci_num_vf(to_pci_dev(xe->drm.dev)); } /** * xe_sriov_pf_admin_only() - Check if PF is mainly used for VFs administration. * @xe: the PF &xe_device * * Return: True if PF is mainly used for VFs administration. */ static inline bool xe_sriov_pf_admin_only(const struct xe_device *xe) { return !xe->info.probe_display; } static inline struct mutex *xe_sriov_pf_master_mutex(struct xe_device *xe) { xe_assert(xe, IS_SRIOV_PF(xe)); return &xe->sriov.pf.master_lock; } int xe_sriov_pf_arm_guard(struct xe_device *xe, struct xe_guard *guard, bool write, void *who); void xe_sriov_pf_disarm_guard(struct xe_device *xe, struct xe_guard *guard, bool write, void *who); #endif