drivers/scsi/snic/vnic_wq.c
Source file repositories/reference/linux-study-clean/drivers/scsi/snic/vnic_wq.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/scsi/snic/vnic_wq.c- Extension
.c- Size
- 4960 bytes
- Lines
- 224
- Domain
- Driver Families
- Bucket
- drivers/scsi
- 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.
- 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.
- 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/errno.hlinux/types.hlinux/pci.hlinux/delay.hlinux/slab.hvnic_dev.hvnic_wq.h
Detected Declarations
function vnic_wq_get_ctrlfunction vnic_wq_alloc_ringfunction vnic_wq_alloc_bufsfunction svnic_wq_freefunction vnic_wq_devcmd2_allocfunction svnic_wq_allocfunction vnic_wq_init_startfunction svnic_wq_initfunction svnic_wq_error_statusfunction svnic_wq_enablefunction svnic_wq_disablefunction svnic_wq_clean
Annotated Snippet
if (!wq->bufs[i]) {
pr_err("Failed to alloc wq_bufs\n");
return -ENOMEM;
}
}
for (i = 0; i < blks; i++) {
buf = wq->bufs[i];
for (j = 0; j < VNIC_WQ_BUF_DFLT_BLK_ENTRIES; j++) {
buf->index = i * VNIC_WQ_BUF_DFLT_BLK_ENTRIES + j;
buf->desc = (u8 *)wq->ring.descs +
wq->ring.desc_size * buf->index;
if (buf->index + 1 == count) {
buf->next = wq->bufs[0];
break;
} else if (j + 1 == VNIC_WQ_BUF_DFLT_BLK_ENTRIES) {
buf->next = wq->bufs[i + 1];
} else {
buf->next = buf + 1;
buf++;
}
}
}
wq->to_use = wq->to_clean = wq->bufs[0];
return 0;
}
void svnic_wq_free(struct vnic_wq *wq)
{
struct vnic_dev *vdev;
unsigned int i;
vdev = wq->vdev;
svnic_dev_free_desc_ring(vdev, &wq->ring);
for (i = 0; i < VNIC_WQ_BUF_BLKS_MAX; i++) {
kfree(wq->bufs[i]);
wq->bufs[i] = NULL;
}
wq->ctrl = NULL;
}
int vnic_wq_devcmd2_alloc(struct vnic_dev *vdev, struct vnic_wq *wq,
unsigned int desc_count, unsigned int desc_size)
{
int err;
wq->index = 0;
wq->vdev = vdev;
err = vnic_wq_get_ctrl(vdev, wq, 0, RES_TYPE_DEVCMD2);
if (err) {
pr_err("Failed to get devcmd2 resource\n");
return err;
}
svnic_wq_disable(wq);
err = vnic_wq_alloc_ring(vdev, wq, 0, desc_count, desc_size);
if (err)
return err;
return 0;
}
int svnic_wq_alloc(struct vnic_dev *vdev, struct vnic_wq *wq,
unsigned int index, unsigned int desc_count, unsigned int desc_size)
{
int err;
wq->index = index;
wq->vdev = vdev;
err = vnic_wq_get_ctrl(vdev, wq, index, RES_TYPE_WQ);
if (err) {
pr_err("Failed to hook WQ[%d] resource\n", index);
return err;
}
svnic_wq_disable(wq);
err = vnic_wq_alloc_ring(vdev, wq, index, desc_count, desc_size);
Annotation
- Immediate include surface: `linux/errno.h`, `linux/types.h`, `linux/pci.h`, `linux/delay.h`, `linux/slab.h`, `vnic_dev.h`, `vnic_wq.h`.
- Detected declarations: `function vnic_wq_get_ctrl`, `function vnic_wq_alloc_ring`, `function vnic_wq_alloc_bufs`, `function svnic_wq_free`, `function vnic_wq_devcmd2_alloc`, `function svnic_wq_alloc`, `function vnic_wq_init_start`, `function svnic_wq_init`, `function svnic_wq_error_status`, `function svnic_wq_enable`.
- Atlas domain: Driver Families / drivers/scsi.
- Implementation status: source 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.