drivers/crypto/intel/qat/qat_common/qat_mig_dev.c
Source file repositories/reference/linux-study-clean/drivers/crypto/intel/qat/qat_common/qat_mig_dev.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/crypto/intel/qat/qat_common/qat_mig_dev.c- Extension
.c- Size
- 3310 bytes
- Lines
- 131
- Domain
- Driver Families
- Bucket
- drivers/crypto
- Inferred role
- Driver Families: exported/initcall integration point
- Status
- integration 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.
- 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.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/dev_printk.hlinux/export.hlinux/pci.hlinux/types.hlinux/qat/qat_mig_dev.hadf_accel_devices.hadf_common_drv.h
Detected Declarations
function qat_vfmig_initfunction qat_vfmig_cleanupfunction qat_vfmig_resetfunction qat_vfmig_openfunction qat_vfmig_closefunction qat_vfmig_suspendfunction qat_vfmig_resumefunction qat_vfmig_save_statefunction qat_vfmig_save_setupfunction qat_vfmig_load_statefunction qat_vfmig_load_setupfunction qat_vfmig_destroyexport qat_vfmig_createexport qat_vfmig_initexport qat_vfmig_cleanupexport qat_vfmig_resetexport qat_vfmig_openexport qat_vfmig_closeexport qat_vfmig_suspendexport qat_vfmig_resumeexport qat_vfmig_save_stateexport qat_vfmig_save_setupexport qat_vfmig_load_stateexport qat_vfmig_load_setupexport qat_vfmig_destroy
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-only
/* Copyright(c) 2024 Intel Corporation */
#include <linux/dev_printk.h>
#include <linux/export.h>
#include <linux/pci.h>
#include <linux/types.h>
#include <linux/qat/qat_mig_dev.h>
#include "adf_accel_devices.h"
#include "adf_common_drv.h"
struct qat_mig_dev *qat_vfmig_create(struct pci_dev *pdev, int vf_id)
{
struct adf_accel_dev *accel_dev;
struct qat_migdev_ops *ops;
struct qat_mig_dev *mdev;
accel_dev = adf_devmgr_pci_to_accel_dev(pdev);
if (!accel_dev)
return ERR_PTR(-ENODEV);
ops = GET_VFMIG_OPS(accel_dev);
if (!ops || !ops->init || !ops->cleanup || !ops->reset || !ops->open ||
!ops->close || !ops->suspend || !ops->resume || !ops->save_state ||
!ops->load_state || !ops->save_setup || !ops->load_setup)
return ERR_PTR(-EINVAL);
mdev = kmalloc_obj(*mdev);
if (!mdev)
return ERR_PTR(-ENOMEM);
mdev->vf_id = vf_id;
mdev->parent_accel_dev = accel_dev;
return mdev;
}
EXPORT_SYMBOL_GPL(qat_vfmig_create);
int qat_vfmig_init(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->init(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_init);
void qat_vfmig_cleanup(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->cleanup(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_cleanup);
void qat_vfmig_reset(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->reset(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_reset);
int qat_vfmig_open(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->open(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_open);
void qat_vfmig_close(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
GET_VFMIG_OPS(accel_dev)->close(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_close);
int qat_vfmig_suspend(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->suspend(mdev);
}
EXPORT_SYMBOL_GPL(qat_vfmig_suspend);
int qat_vfmig_resume(struct qat_mig_dev *mdev)
{
struct adf_accel_dev *accel_dev = mdev->parent_accel_dev;
return GET_VFMIG_OPS(accel_dev)->resume(mdev);
Annotation
- Immediate include surface: `linux/dev_printk.h`, `linux/export.h`, `linux/pci.h`, `linux/types.h`, `linux/qat/qat_mig_dev.h`, `adf_accel_devices.h`, `adf_common_drv.h`.
- Detected declarations: `function qat_vfmig_init`, `function qat_vfmig_cleanup`, `function qat_vfmig_reset`, `function qat_vfmig_open`, `function qat_vfmig_close`, `function qat_vfmig_suspend`, `function qat_vfmig_resume`, `function qat_vfmig_save_state`, `function qat_vfmig_save_setup`, `function qat_vfmig_load_state`.
- Atlas domain: Driver Families / drivers/crypto.
- Implementation status: integration implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.