sound/xen/xen_snd_front.h

File Facts

System

Linux kernel

Corpus path

sound/xen/xen_snd_front.h

Extension

.h

Size

1489 bytes

Lines

55

Domain

Driver Families

Bucket

sound/xen

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

• xen_snd_front_cfg.h

Detected Declarations

• struct xen_snd_front_card_info
• struct xen_snd_front_evtchnl
• struct xen_snd_front_evtchnl_pair
• struct xen_front_pgdir_shbuf
• struct xensnd_query_hw_param
• struct xen_snd_front_info

Annotated Snippet

struct xen_snd_front_info {
	struct xenbus_device *xb_dev;

	struct xen_snd_front_card_info *card_info;

	int num_evt_pairs;
	struct xen_snd_front_evtchnl_pair *evt_pairs;

	struct xen_front_cfg_card cfg;
};

int xen_snd_front_stream_query_hw_param(struct xen_snd_front_evtchnl *evtchnl,
					struct xensnd_query_hw_param *hw_param_req,
					struct xensnd_query_hw_param *hw_param_resp);

int xen_snd_front_stream_prepare(struct xen_snd_front_evtchnl *evtchnl,
				 struct xen_front_pgdir_shbuf *shbuf,
				 u8 format, unsigned int channels,
				 unsigned int rate, u32 buffer_sz,
				 u32 period_sz);

int xen_snd_front_stream_close(struct xen_snd_front_evtchnl *evtchnl);

int xen_snd_front_stream_write(struct xen_snd_front_evtchnl *evtchnl,
			       unsigned long pos, unsigned long count);

int xen_snd_front_stream_read(struct xen_snd_front_evtchnl *evtchnl,
			      unsigned long pos, unsigned long count);

int xen_snd_front_stream_trigger(struct xen_snd_front_evtchnl *evtchnl,
				 int type);

#endif /* __XEN_SND_FRONT_H */

Annotation

• Immediate include surface: `xen_snd_front_cfg.h`.
• Detected declarations: `struct xen_snd_front_card_info`, `struct xen_snd_front_evtchnl`, `struct xen_snd_front_evtchnl_pair`, `struct xen_front_pgdir_shbuf`, `struct xensnd_query_hw_param`, `struct xen_snd_front_info`.
• Atlas domain: Driver Families / sound/xen.
• 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.