tools/sched_ext/scx_qmap.h

Source file repositories/reference/linux-study-clean/tools/sched_ext/scx_qmap.h

File Facts

System
Linux kernel
Corpus path
tools/sched_ext/scx_qmap.h
Extension
.h
Size
2028 bytes
Lines
74
Domain
Support Tooling And Documentation
Bucket
tools
Inferred role
Support Tooling And Documentation: implementation source
Status
source implementation candidate

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

struct cpu_ctx {
	__u64 dsp_idx;		/* dispatch index */
	__u64 dsp_cnt;		/* remaining count */
	__u32 avg_weight;
	__u32 cpuperf_target;
};

/* Opaque to userspace; defined in scx_qmap.bpf.c. */
struct task_ctx;

struct qmap_fifo {
	struct task_ctx __arena *head;
	struct task_ctx __arena *tail;
	__s32 idx;
};

struct qmap_arena {
	/* userspace-visible stats */
	__u64 nr_enqueued, nr_dispatched, nr_reenqueued, nr_reenqueued_cid0;
	__u64 nr_dequeued, nr_ddsp_from_enq;
	__u64 nr_core_sched_execed;
	__u64 nr_expedited_local, nr_expedited_remote;
	__u64 nr_expedited_lost, nr_expedited_from_timer;
	__u64 nr_highpri_queued;
	__u32 test_error_cnt;
	__u32 cpuperf_min, cpuperf_avg, cpuperf_max;
	__u32 cpuperf_target_min, cpuperf_target_avg, cpuperf_target_max;

	/* kernel-side runtime state */
	__u64 sub_sched_cgroup_ids[MAX_SUB_SCHEDS];
	__u64 core_sched_head_seqs[5];
	__u64 core_sched_tail_seqs[5];

	struct cpu_ctx cpu_ctxs[SCX_QMAP_MAX_CPUS];

	/* task_ctx slab; allocated and threaded by qmap_init() */
	struct task_ctx __arena *task_ctxs;
	struct task_ctx __arena *task_free_head;

	/* five priority FIFOs, each a doubly-linked list through task_ctx */
	struct qmap_fifo fifos[5];
};

#endif /* __SCX_QMAP_H */

Annotation

Implementation Notes