drivers/gpu/drm/xe/xe_sriov_pf_helpers.h

Source file repositories/reference/linux-study-clean/drivers/gpu/drm/xe/xe_sriov_pf_helpers.h

File Facts

System
Linux kernel
Corpus path
drivers/gpu/drm/xe/xe_sriov_pf_helpers.h
Extension
.h
Size
2166 bytes
Lines
76
Domain
Driver Families
Bucket
drivers/gpu
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef _XE_SRIOV_PF_HELPERS_H_
#define _XE_SRIOV_PF_HELPERS_H_

#include "xe_assert.h"
#include "xe_device.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)
{
	xe_assert(xe, IS_SRIOV_PF(xe));
	return xe_device_is_admin_only(xe);
}

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

Annotation

Implementation Notes