drivers/gpu/drm/xe/xe_gt_topology.h
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/xe/xe_gt_topology.h
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/xe/xe_gt_topology.h- Extension
.h- Size
- 1450 bytes
- Lines
- 57
- Domain
- Driver Families
- Bucket
- drivers/gpu
- 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
xe_gt_types.h
Detected Declarations
struct drm_printerfunction xe_gt_topology_mask_last_dss
Annotated Snippet
#ifndef _XE_GT_TOPOLOGY_H_
#define _XE_GT_TOPOLOGY_H_
#include "xe_gt_types.h"
/*
* Loop over each DSS with the bit is 1 in geometry or compute mask
* @dss: iterated DSS bit from the DSS mask
* @gt: GT structure
*/
#define for_each_dss(dss, gt) \
for_each_or_bit((dss), \
(gt)->fuse_topo.g_dss_mask, \
(gt)->fuse_topo.c_dss_mask, \
XE_MAX_DSS_FUSE_BITS)
struct drm_printer;
void xe_gt_topology_init(struct xe_gt *gt);
int xe_gt_topology_dump(struct xe_gt *gt, struct drm_printer *p);
/**
* xe_gt_topology_mask_last_dss() - Returns the index of the last DSS in a mask.
* @mask: Input DSS mask
*
* Return: Index of the last DSS in the input DSS mask,
* XE_MAX_DSS_FUSE_BITS if DSS mask is empty.
*/
static inline unsigned int
xe_gt_topology_mask_last_dss(const xe_dss_mask_t mask)
{
return find_last_bit(mask, XE_MAX_DSS_FUSE_BITS);
}
unsigned int
xe_dss_mask_group_ffs(const xe_dss_mask_t mask, int groupsize, int groupnum);
unsigned int
xe_l3_bank_mask_ffs(const xe_l3_bank_mask_t mask);
bool
xe_gt_topology_has_dss_in_quadrant(struct xe_gt *gt, int quad);
bool xe_gt_has_geometry_dss(struct xe_gt *gt, unsigned int dss);
bool xe_gt_has_compute_dss(struct xe_gt *gt, unsigned int dss);
bool xe_gt_has_discontiguous_dss_groups(const struct xe_gt *gt);
bool xe_gt_topology_report_l3(struct xe_gt *gt);
#endif /* _XE_GT_TOPOLOGY_H_ */
Annotation
- Immediate include surface: `xe_gt_types.h`.
- Detected declarations: `struct drm_printer`, `function xe_gt_topology_mask_last_dss`.
- Atlas domain: Driver Families / drivers/gpu.
- 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.