drivers/vfio/pci/pds/dirty.h

File Facts

System

Linux kernel

Corpus path

drivers/vfio/pci/pds/dirty.h

Extension

.h

Size

1145 bytes

Lines

42

Domain

Driver Families

Bucket

drivers/vfio

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.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• No C-style include directives detected by the generator.

Detected Declarations

• struct pds_vfio_region
• struct pds_vfio_dirty
• struct pds_vfio_pci_device

Annotated Snippet

struct pds_vfio_region {
	unsigned long *host_seq;
	unsigned long *host_ack;
	u64 bmp_bytes;
	u64 size;
	u64 start;
	u64 page_size;
	struct pds_lm_sg_elem *sgl;
	dma_addr_t sgl_addr;
	u32 dev_bmp_offset_start_byte;
	u16 num_sge;
};

struct pds_vfio_dirty {
	struct pds_vfio_region *regions;
	u8 num_regions;
	bool is_enabled;
};

struct pds_vfio_pci_device;

bool pds_vfio_dirty_is_enabled(struct pds_vfio_pci_device *pds_vfio);
void pds_vfio_dirty_set_enabled(struct pds_vfio_pci_device *pds_vfio);
void pds_vfio_dirty_set_disabled(struct pds_vfio_pci_device *pds_vfio);
void pds_vfio_dirty_disable(struct pds_vfio_pci_device *pds_vfio,
			    bool send_cmd);

int pds_vfio_dma_logging_report(struct vfio_device *vdev, unsigned long iova,
				unsigned long length,
				struct iova_bitmap *dirty);
int pds_vfio_dma_logging_start(struct vfio_device *vdev,
			       struct rb_root_cached *ranges, u32 nnodes,
			       u64 *page_size);
int pds_vfio_dma_logging_stop(struct vfio_device *vdev);
#endif /* _DIRTY_H_ */

Annotation

• Detected declarations: `struct pds_vfio_region`, `struct pds_vfio_dirty`, `struct pds_vfio_pci_device`.
• Atlas domain: Driver Families / drivers/vfio.
• 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.