include/drm/intel/xe_sriov_vfio.h

Source file repositories/reference/linux-study-clean/include/drm/intel/xe_sriov_vfio.h

File Facts

System
Linux kernel
Corpus path
include/drm/intel/xe_sriov_vfio.h
Extension
.h
Size
5304 bytes
Lines
155
Domain
Repository Root And Misc
Bucket
include
Inferred role
Repository Root And Misc: implementation source
Status
source implementation candidate

Why This File Exists

Top-level or miscellaneous repository surface. Use this as map coverage unless a later manual pass promotes the file into a deeper subsystem dossier.

Dependency Surface

Detected Declarations

Annotated Snippet

#ifndef _XE_SRIOV_VFIO_H_
#define _XE_SRIOV_VFIO_H_

#include <linux/types.h>

struct pci_dev;
struct xe_device;

/**
 * xe_sriov_vfio_get_pf() - Get PF &xe_device.
 * @pdev: the VF &pci_dev device
 *
 * Return: pointer to PF &xe_device, NULL otherwise.
 */
struct xe_device *xe_sriov_vfio_get_pf(struct pci_dev *pdev);

/**
 * xe_sriov_vfio_migration_supported() - Check if migration is supported.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 *
 * Return: true if migration is supported, false otherwise.
 */
bool xe_sriov_vfio_migration_supported(struct xe_device *xe);

/**
 * xe_sriov_vfio_flr_prepare() - Notify PF that VF FLR prepare has started.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * This function marks VF FLR as pending before PF receives GuC FLR event.
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_flr_prepare(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_wait_flr_done() - Wait for VF FLR completion.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * This function will wait until VF FLR is processed by PF on all tiles (or
 * until timeout occurs).
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_wait_flr_done(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_suspend_device() - Suspend VF.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * This function will pause VF on all tiles/GTs.
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_suspend_device(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_resume_device() - Resume VF.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * This function will resume VF on all tiles.
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_resume_device(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_stop_copy_enter() - Initiate a VF device migration data save.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_stop_copy_enter(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_stop_copy_exit() - Finish a VF device migration data save.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()
 * @vfid: the VF identifier (can't be 0)
 *
 * Return: 0 on success or a negative error code on failure.
 */
int xe_sriov_vfio_stop_copy_exit(struct xe_device *xe, unsigned int vfid);

/**
 * xe_sriov_vfio_resume_data_enter() - Initiate a VF device migration data restore.
 * @xe: the PF &xe_device obtained by calling xe_sriov_vfio_get_pf()

Annotation

Implementation Notes