drivers/crypto/intel/qat/qat_common/adf_cnv_dbgfs.c
Source file repositories/reference/linux-study-clean/drivers/crypto/intel/qat/qat_common/adf_cnv_dbgfs.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/crypto/intel/qat/qat_common/adf_cnv_dbgfs.c- Extension
.c- Size
- 7680 bytes
- Lines
- 300
- Domain
- Driver Families
- Bucket
- drivers/crypto
- Inferred role
- Driver Families: operation-table or driver-model contract
- Status
- pattern 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.
- Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
- 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/bitfield.hlinux/debugfs.hlinux/kernel.hadf_accel_devices.hadf_admin.hadf_common_drv.hadf_cnv_dbgfs.hqat_compression.h
Detected Declarations
struct ae_cnv_errorsstruct cnv_err_statsenum cnv_error_typeenum cnv_fieldsfunction get_err_infofunction qat_cnv_errors_seq_stopfunction cnv_err_stats_allocfunction qat_cnv_errors_file_openfunction qat_cnv_errors_file_releasefunction no_comp_file_readfunction adf_cnv_dbgfs_addfunction adf_cnv_dbgfs_rm
Annotated Snippet
static const struct file_operations qat_cnv_fops = {
.owner = THIS_MODULE,
.open = qat_cnv_errors_file_open,
.read = seq_read,
.llseek = seq_lseek,
.release = qat_cnv_errors_file_release,
};
static ssize_t no_comp_file_read(struct file *f, char __user *buf, size_t count,
loff_t *pos)
{
char *file_msg = "No engine configured for comp\n";
return simple_read_from_buffer(buf, count, pos, file_msg,
strlen(file_msg));
}
static const struct file_operations qat_cnv_no_comp_fops = {
.owner = THIS_MODULE,
.read = no_comp_file_read,
};
void adf_cnv_dbgfs_add(struct adf_accel_dev *accel_dev)
{
const struct file_operations *fops;
void *data;
if (adf_hw_dev_has_compression(accel_dev)) {
fops = &qat_cnv_fops;
data = accel_dev;
} else {
fops = &qat_cnv_no_comp_fops;
data = NULL;
}
accel_dev->cnv_dbgfile = debugfs_create_file(CNV_DEBUGFS_FILENAME, 0400,
accel_dev->debugfs_dir,
data, fops);
}
void adf_cnv_dbgfs_rm(struct adf_accel_dev *accel_dev)
{
debugfs_remove(accel_dev->cnv_dbgfile);
accel_dev->cnv_dbgfile = NULL;
}
Annotation
- Immediate include surface: `linux/bitfield.h`, `linux/debugfs.h`, `linux/kernel.h`, `adf_accel_devices.h`, `adf_admin.h`, `adf_common_drv.h`, `adf_cnv_dbgfs.h`, `qat_compression.h`.
- Detected declarations: `struct ae_cnv_errors`, `struct cnv_err_stats`, `enum cnv_error_type`, `enum cnv_fields`, `function get_err_info`, `function qat_cnv_errors_seq_stop`, `function cnv_err_stats_alloc`, `function qat_cnv_errors_file_open`, `function qat_cnv_errors_file_release`, `function no_comp_file_read`.
- Atlas domain: Driver Families / drivers/crypto.
- Implementation status: pattern 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.