/* Copyright (c) Meta Platforms, Inc. and affiliates. */

#ifdef LSP
#ifndef __bpf__
#define __bpf__
#endif
#include "../../../../include/scx/common.bpf.h"
#include "../../../../include/scx/namespace_impl.bpf.h"
#else
#include <scx/common.bpf.h>
#include <scx/namespace_impl.bpf.h>
#endif

#include <errno.h>
#include <stdbool.h>
#include <bpf/bpf_core_read.h>
#include <bpf/bpf_helpers.h>
#include <bpf/bpf_tracing.h>

#include <lib/pmu.h>
#include <lib/cleanup.bpf.h>

#include "intf.h"
#include "timer.bpf.h"
#include "util.bpf.h"

char _license[] SEC("license") = "GPL";

extern unsigned CONFIG_HZ __kconfig;

static u32 do_refresh_layer_cpumasks = 0;

const volatile u32 debug;
const volatile u64 slice_ns;
const volatile u64 max_exec_ns;
const volatile u32 nr_cpu_ids = 1;
const volatile u32 nr_possible_cpus = 1;
const volatile u64 numa_cpumasks[MAX_NUMA_NODES][MAX_CPUS / 64];
const volatile u32 llc_numa_id_map[MAX_LLCS];
const volatile u32 cpu_llc_id_map[MAX_CPUS];
const volatile u32 nr_layers = 1;
const volatile u32 nr_nodes = 32;	/* !0 for veristat, set during init */
const volatile u32 nr_llcs = 32;	/* !0 for veristat, set during init */
const volatile bool smt_enabled = true;
const volatile bool has_little_cores = true;
const volatile s32 __sibling_cpu[MAX_CPUS];
const volatile bool monitor_disable = false;
const volatile unsigned char all_cpus[MAX_CPUS_U8];
const volatile u32 layer_iteration_order[MAX_LAYERS];
const volatile u32 nr_op_layers;	/* open && preempt */
const volatile u32 nr_on_layers;	/* open && !preempt */
const volatile u32 nr_gp_layers;	/* grouped && preempt */
const volatile u32 nr_gn_layers;	/* grouped && !preempt */
const volatile u32 nr_excl_layers;
const volatile bool kfuncs_supported_in_syscall = true;
const volatile u64 min_open_layer_disallow_open_after_ns;
const volatile u64 min_open_layer_disallow_preempt_after_ns;
const volatile u64 lo_fb_wait_ns = 5000000;	/* !0 for veristat */
const volatile u32 lo_fb_share_ppk = 128;	/* !0 for veristat */
const volatile bool percpu_kthread_preempt = true;
const volatile bool percpu_kthread_preempt_all = false;
const volatile u64 membw_event = 0;
volatile u64 layer_refresh_seq_avgruntime;

/* Flag to enable or disable antistall feature */
const volatile bool enable_antistall = true;
const volatile bool enable_match_debug = false;
const volatile bool enable_gpu_support = false;
const volatile u32 nr_cgroup_regexes = 0;
/* Delay permitted, in seconds, before antistall activates */
const volatile u64 antistall_sec = 3;
const u32 zero_u32 = 0;
/* Move matching thread name to hi_fb */
const volatile bool enable_hi_fb_thread_name_match = false;
const volatile char hi_fb_thread_name[16];

/*
 * XXX sched classes should be exported kernel
 * side to avoid having to do this...
 */
const volatile u64 ext_sched_class_addr = 0;
const volatile u64 idle_sched_class_addr = 0;

private(unprotected_cpumask) struct bpf_cpumask __kptr *unprotected_cpumask;
u64 unprotected_seq = 0;

private(all_cpumask) struct bpf_cpumask __kptr *all_cpumask;
private(big_cpumask) struct bpf_cpumask __kptr *big_cpumask;
struct layer layers[MAX_LAYERS];
u32 fallback_cpus[MAX_NUMA_NODES];
u32 layered_root_tgid = 0;

UEI_DEFINE(uei);

struct task_hint {
	u64 hint;
	u64 __reserved[3];
};

struct {
	__uint(type, BPF_MAP_TYPE_TASK_STORAGE);
	__uint(map_flags, BPF_F_NO_PREALLOC);
	__type(key, int);
	__type(value, struct task_hint);
} scx_layered_task_hint_map SEC(".maps");

struct {
	__uint(type, BPF_MAP_TYPE_ARRAY);
	__type(key, u32);
	__type(value, struct hint_layer_info);
	__uint(map_flags, 0);
	__uint(max_entries, 1025);
} hint_to_layer_id_map SEC(".maps");

const volatile bool task_hint_map_enabled;

/* EWMA value updated from userspace */
u64 system_cpu_util_ewma = 0;
u64 layer_dsq_insert_ewma[MAX_LAYERS];

static inline s32 prio_to_nice(s32 static_prio)
{
	/* See DEFAULT_PRIO and PRIO_TO_NICE in include/linux/sched/prio.h */
	return static_prio - 120;
}

static inline bool is_percpu_kthread(struct task_struct *p)
{
	return (p->flags & PF_KTHREAD) && p->nr_cpus_allowed == 1;
}

static inline bool is_percpu_kthread_preempting(struct task_struct *p)
{
	return percpu_kthread_preempt &&
		(percpu_kthread_preempt_all || p->scx.weight > 100);
}

static inline s32 sibling_cpu(s32 cpu)
{
	const volatile s32 *sib;

	if (!smt_enabled)
		return -1;

	sib = MEMBER_VPTR(__sibling_cpu, [cpu]);
	if (sib)
		return *sib;
	else
		return -1;
}

static __always_inline struct layer *lookup_layer(u32 id)
{
	if (id >= nr_layers) {
		scx_bpf_error("invalid layer %d", id);
		return NULL;
	}
	return &layers[id];
}

// return the dsq id for the layer based on the LLC id.
static __noinline u64 layer_dsq_id(u32 layer_id, u32 llc_id)
{
	return ((u64)layer_id << DSQ_ID_LAYER_SHIFT) | llc_id;
}

// XXX - older kernels get confused by RCU state when subprogs are called from
// sleepable functions. Use __always_inline.
static __always_inline u32 cpu_to_llc_id(s32 cpu_id)
{
        const volatile u32 *llc_ptr;

        llc_ptr = MEMBER_VPTR(cpu_llc_id_map, [cpu_id]);
        if (!llc_ptr) {
                scx_bpf_error("Couldn't look up llc ID for cpu %d", cpu_id);
                return 0;
        }
        return *llc_ptr;
}

u32 llc_node_id(u32 llc_id)
{
        const volatile u32 *llc_ptr;

        llc_ptr = MEMBER_VPTR(llc_numa_id_map, [llc_id]);
        if (!llc_ptr) {
                scx_bpf_error("Couldn't look up llc ID for %d", llc_id);
                return 0;
        }
        return *llc_ptr;
}

static u64 hi_fb_dsq_id(u32 llc_id)
{
	return HI_FB_DSQ_BASE | llc_id;
}

static u64 lo_fb_dsq_id(u32 llc_id)
{
	return LO_FB_DSQ_BASE | llc_id;
}

static __always_inline bool is_scheduler_task(struct task_struct *p)
{
	return (u32)p->tgid == layered_root_tgid;
}

struct {
	__uint(type, BPF_MAP_TYPE_PERCPU_ARRAY);
	__type(key, u32);
	__type(value, struct cpu_ctx);
	__uint(max_entries, 1);
} cpu_ctxs SEC(".maps");

static struct cpu_ctx *lookup_cpu_ctx(int cpu)
{
	struct cpu_ctx *cpuc;

	if (cpu < 0)
		cpuc = bpf_map_lookup_elem(&cpu_ctxs, &zero_u32);
	else
		cpuc = bpf_map_lookup_percpu_elem(&cpu_ctxs, &zero_u32, cpu);

	if (!cpuc) {
		scx_bpf_error("no cpu_ctx for cpu %d", cpu);
		return NULL;
	}

	return cpuc;
}

static bool cpuc_in_layer(struct cpu_ctx *cpuc, struct layer *layer)
{
	if (layer->kind == LAYER_KIND_OPEN)
		return cpuc->in_open_layers;
	else
		return cpuc->layer_id == layer->id;
}

struct {
	__uint(type, BPF_MAP_TYPE_HASH);
	__type(key, u32);
	__type(value, u32);
	__uint(max_entries, MAX_TASKS);
	__uint(map_flags, BPF_F_NO_PREALLOC);
} layer_match_dbg SEC(".maps");

/*
 * Maps for storing GPU usage information. Keys are the tgid of the
 * task group that has recently used a GPU API call. The value represents
 * the time until which the entry is valid. Entries are checked and
 * possibly removed at layer matching time, and updated when the GPU
 * API is used by a task group.
 */
struct {
	__uint(type, BPF_MAP_TYPE_HASH);
	__type(key, u32);
	__type(value, u64);
	__uint(max_entries, MAX_GPU_PIDS);
	__uint(map_flags, BPF_F_NO_PREALLOC);
} gpu_tgid SEC(".maps");

/*
 * See comment for gpu_tgid - same mechanism, except for individual tasks.
 */
struct {
	__uint(type, BPF_MAP_TYPE_HASH);
	__type(key, u32);
	__type(value, u64);
	__uint(max_entries, MAX_GPU_PIDS);
	__uint(map_flags, BPF_F_NO_PREALLOC);
} gpu_tid SEC(".maps");

struct {
	__uint(type, BPF_MAP_TYPE_HASH);
	__type(key, u64);
	__type(value, u64);
	__uint(max_entries, 16384);
	__uint(map_flags, BPF_F_NO_PREALLOC);
} cgroup_match_bitmap SEC(".maps");

// XXX - Converting this to bss array triggers verifier bugs. See
// BpfStats::read(). Should also be cacheline aligned which doesn't work with
// the array map.
struct {
	__uint(type, BPF_MAP_TYPE_ARRAY);
	__type(key, u32);
	__type(value, struct node_ctx);
	__uint(max_entries, MAX_NUMA_NODES);
	__uint(map_flags, 0);
} node_data SEC(".maps");

static struct node_ctx *lookup_node_ctx(u32 node)
{
	struct node_ctx *nodec;

	if (!(nodec = bpf_map_lookup_elem(&node_data, &node)))
		scx_bpf_error("no node_ctx");
	return nodec;
}

// XXX - Converting this to bss array triggers verifier bugs. See
// BpfStats::read(). Should also be cacheline aligned which doesn't work with
// the array map.
struct {
	__uint(type, BPF_MAP_TYPE_ARRAY);
	__type(key, u32);
	__type(value, struct llc_ctx);
	__uint(max_entries, MAX_LLCS);
	__uint(map_flags, 0);
} llc_data SEC(".maps");

static struct llc_ctx *lookup_llc_ctx(u32 llc_id)
{
	struct llc_ctx *llcc;

	if (!(llcc = bpf_map_lookup_elem(&llc_data, &llc_id)))
		scx_bpf_error("no llc_ctx");
	return llcc;
}

static void gstat_add(u32 id, struct cpu_ctx *cpuc, s64 delta)
{
	if (id >= NR_GSTATS) {
		scx_bpf_error("invalid global stat id %d", id);
		return;
	}

	cpuc->gstats[id] += delta;
}

static void gstat_inc(u32 id, struct cpu_ctx *cpuc)
{
	gstat_add(id, cpuc, 1);
}

static void lstat_add(u32 id, struct layer *layer, struct cpu_ctx *cpuc, s64 delta)
{
	u64 *vptr;

	if ((vptr = MEMBER_VPTR(*cpuc, .lstats[layer->id][id])))
		(*vptr) += delta;
	else
		scx_bpf_error("invalid layer or stat ids: %d, %d", id, layer->id);
}

static void lstat_inc(u32 id, struct layer *layer, struct cpu_ctx *cpuc)
{
	lstat_add(id, layer, cpuc, 1);
}

struct layer_cpumask_wrapper {
	struct bpf_cpumask __kptr *cpumask;
	struct bpf_cpumask __kptr *cpuset;
};

struct {
	__uint(type, BPF_MAP_TYPE_ARRAY);
	__type(key, u32);
	__type(value, struct layer_cpumask_wrapper);
	__uint(max_entries, MAX_LAYERS);
	__uint(map_flags, 0);
} layer_cpumasks SEC(".maps");

/*
 * Per-layer per-node cpumasks (layer cpumask & node cpumask). Stored in a
 * separate map because struct layer is in BSS which is mmapped and can't
 * contain kptrs. Keyed by layer_id * MAX_NUMA_NODES + node_id.
 */
struct layer_node_cpumask_wrapper {
	struct bpf_cpumask __kptr *cpumask;
};

struct {
	__uint(type, BPF_MAP_TYPE_ARRAY);
	__type(key, u32);
	__type(value, struct layer_node_cpumask_wrapper);
	__uint(max_entries, MAX_LAYERS * MAX_NUMA_NODES);
	__uint(map_flags, 0);
} layer_node_cpumasks SEC(".maps");

static struct cpumask *lookup_layer_node_cpumask(u32 layer_id, u32 node_id)
{
	struct layer_node_cpumask_wrapper *w;
	u32 key = layer_id * MAX_NUMA_NODES + node_id;

	if ((w = bpf_map_lookup_elem(&layer_node_cpumasks, &key)))
		return (struct cpumask *)w->cpumask;

	scx_bpf_error("no layer_node_cpumask for layer %d node %d",
		       layer_id, node_id);
	return NULL;
}

static struct cpumask *lookup_layer_cpumask(u32 layer_id)
{
	struct layer_cpumask_wrapper *cpumaskw;

	if ((cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id))) {
		return (struct cpumask *)cpumaskw->cpumask;
	} else {
		scx_bpf_error("no layer_cpumask for layer %d", layer_id);
		return NULL;
	}
}

static struct bpf_cpumask *lookup_layer_cpuset(u32 layer_id)
{
	struct layer_cpumask_wrapper *cpumaskw;

	if ((cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id))) {
		return cpumaskw->cpuset;
	} else {
		scx_bpf_error("no layer_cpuset for layer %d", layer_id);
		return NULL;
	}
}

static void layer_llc_drain_enable(struct layer *layer, u32 llc_id)
{
	u32 nid = llc_node_id(llc_id);

	if (nid >= MAX_NUMA_NODES)
		return;
	__sync_or_and_fetch(&layer->node[nid].llcs_to_drain, 1LLU << llc_id);
}

static void layer_llc_drain_disable(struct layer *layer, u32 llc_id)
{
	u32 nid = llc_node_id(llc_id);

	if (nid >= MAX_NUMA_NODES)
		return;
	__sync_and_and_fetch(&layer->node[nid].llcs_to_drain, ~(1LLU << llc_id));
}

static inline bool refresh_layer_cpuc(struct cpu_ctx *cpuc, struct layer *layer)
{
	/* a CPU can be shared by multiple open layers */
	cpuc->in_open_layers = (layer->kind == LAYER_KIND_OPEN);
	cpuc->layer_id = (layer->kind == LAYER_KIND_OPEN) ? MAX_LAYERS : layer->id;

	if (cpuc->is_protected == layer->is_protected)
		return false;

	cpuc->is_protected = layer->is_protected;
	if (unlikely(!unprotected_cpumask)) {
		scx_bpf_error("unprotected_cpumask not initialized");
		return false;
	}

	/* The mask tracks _unprotected_ CPUs to simplify bitops. */
	if (cpuc->is_protected)
		bpf_cpumask_clear_cpu(cpuc->cpu, unprotected_cpumask);
	else
		bpf_cpumask_set_cpu(cpuc->cpu, unprotected_cpumask);

	/* Called under scoped_guard(rcu) from refresh_cpumasks() — don't nest */
	struct node_ctx *nodec = lookup_node_ctx(cpuc->node_id);

	if (nodec && nodec->unprotected_cpumask) {
		if (cpuc->is_protected)
			bpf_cpumask_clear_cpu(cpuc->cpu,
					      nodec->unprotected_cpumask);
		else
			bpf_cpumask_set_cpu(cpuc->cpu,
					    nodec->unprotected_cpumask);
	}

	return true;
}

/*
 * Create a bpf_cpumask for the layer out of the serialized cpuset store by userspace.
 * Deserialization logic identical to refresh_cpumasks.
 */
static void layer_cpuset_bpfmask(int layer_id)
{
	struct bpf_cpumask *layer_cpuset;
	u8 *u8_ptr;
	int cpu;

	scoped_guard(rcu) {
		bpf_for(cpu, 0, nr_possible_cpus) {
			u8_ptr = MEMBER_VPTR(layers, [layer_id].cpuset[cpu / 8]);
			if (!u8_ptr) {
				scx_bpf_error("could not find cpuset byte");
				return;
			}

			layer_cpuset = lookup_layer_cpuset(layer_id);
			if (!layer_cpuset) {
				scx_bpf_error("uninitialized cpuset");
				return;
			}

			if (*u8_ptr & (1 << (cpu % 8)))
				bpf_cpumask_set_cpu(cpu, layer_cpuset);
			else
				bpf_cpumask_clear_cpu(cpu, layer_cpuset);
		}
	}
}

/*
 * Returns if any cpus were added to the layer.
 */
__weak s32 refresh_cpumasks(u32 layer_id)
{
	struct bpf_cpumask *layer_cpumask;
	struct layer_cpumask_wrapper *cpumaskw;
	bool protected_changed = false;
	struct layer *layer;
	struct cpu_ctx *cpuc;
	int cpu, llc_id;

	layer = MEMBER_VPTR(layers, [layer_id]);
	if (!layer) {
		scx_bpf_error("can't happen");
		return 0;
	}

	if (!__sync_val_compare_and_swap(&layer->refresh_cpus, 1, 0))
		return 0;

	scoped_guard(rcu) {
		if (!(cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id)) ||
		    !(layer_cpumask = cpumaskw->cpumask)) {
			scx_bpf_error("can't happen");
			return 0;
		}

		bpf_for(cpu, 0, nr_possible_cpus) {
			u8 *u8_ptr;

			if (!(cpuc = lookup_cpu_ctx(cpu)))
				return 0;

			if ((u8_ptr = MEMBER_VPTR(layers, [layer_id].cpus[cpu / 8]))) {
				if (*u8_ptr & (1 << (cpu % 8))) {
					protected_changed = refresh_layer_cpuc(cpuc, layer) || protected_changed;

					bpf_cpumask_set_cpu(cpu, layer_cpumask);
				} else {
					if (layer->kind == LAYER_KIND_OPEN)
						cpuc->in_open_layers = false;
					else if (cpuc->layer_id == layer_id) {
						cpuc->layer_id = MAX_LAYERS;
						cpuc->in_open_layers = true;

						/* Belongs to no layer, so none of these hold. */
						cpuc->protect_owned = false;
						cpuc->protect_owned_preempt = false;

					}
					bpf_cpumask_clear_cpu(cpu, layer_cpumask);
				}
			} else {
				scx_bpf_error("can't happen");
			}
		}
	}

	/* Update per-node layer cpumasks (layer cpumask & node cpumask). */
	cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id);
	scoped_guard(rcu) {
		struct node_ctx *nodec;
		u32 nid;

		bpf_for(nid, 0, nr_nodes) {
			struct layer_node_cpumask_wrapper *node_cpumaskw;
			struct bpf_cpumask *layer_cpumask_ptr;
			u32 key = layer_id * MAX_NUMA_NODES + nid;

			node_cpumaskw = bpf_map_lookup_elem(&layer_node_cpumasks, &key);
			nodec = lookup_node_ctx(nid);
			if (!cpumaskw || !node_cpumaskw || !nodec)
				continue;

			layer_cpumask_ptr = cpumaskw->cpumask;
			if (!layer_cpumask_ptr ||
			    !node_cpumaskw->cpumask || !nodec->cpumask)
				continue;

			bpf_cpumask_and(node_cpumaskw->cpumask,
					(const struct cpumask *)layer_cpumask_ptr,
					(const struct cpumask *)nodec->cpumask);
		}
	}

	if (protected_changed)
		__sync_fetch_and_add(&unprotected_seq, 1);

	__sync_fetch_and_add(&layer->cpus_seq, 1);	/* MB, see below */
	trace("LAYER[%d] now has %d cpus, seq=%llu", layer_id, layer->nr_cpus, layer->cpus_seq);

	/*
	 * layer->nr_llc_cpus[] were updated by the userspace and we've passed a
	 * full MB in the above layer->cpus_seq update. This is interlocked with
	 * layered_enqueue() to guarantee that a task is never left in an empty
	 * LLC without draining enabled. Either they see 0 nr_llcs_cpus and
	 * enable drain or we see the task it enqueued and enable drain.
	 */
	bpf_for(llc_id, 0, nr_llcs) {
		if (layer->nr_llc_cpus[llc_id])
			layer_llc_drain_disable(layer, llc_id);
		else if (scx_bpf_dsq_nr_queued(layer_dsq_id(layer->id, llc_id)))
			layer_llc_drain_enable(layer, llc_id);
	}

	bpf_for(cpu, 0, nr_possible_cpus) {
		if (!(cpuc = lookup_cpu_ctx(cpu)))
			return 0;
		if (cpuc_in_layer(cpuc, layer))
			scx_bpf_kick_cpu(cpu, SCX_KICK_IDLE);
	}
	return 0;
}

static __always_inline void maybe_refresh_layer_cpumasks()
{
	if (kfuncs_supported_in_syscall || !__sync_lock_test_and_set(&do_refresh_layer_cpumasks, 0))
		return;

	u32 id;

	bpf_for(id, 0, nr_layers)
		refresh_cpumasks(id);
}

/*
 * Refreshes all layer cpumasks, this is called via BPF_PROG_RUN from userspace.
 */
SEC("syscall")
int BPF_PROG(refresh_layer_cpumasks)
{
	if (!kfuncs_supported_in_syscall) {
		// BACKPORT NOTE: We can't call `bpf_cpumask_{set,clear}_cpu` from a
		// BPF_PROG. Set a flag and take care of it later.
		__sync_fetch_and_or(&do_refresh_layer_cpumasks, 1);
		return 0;
	}

	u32 id;

	bpf_for(id, 0, nr_layers)
		refresh_cpumasks(id);

	return 0;
}

SEC("syscall")
int refresh_node_ctx(struct refresh_node_ctx_arg *arg)
{
	struct node_ctx *nodec;

	if (!(nodec = lookup_node_ctx(arg->node_id)))
		return -ENOENT;

	nodec->nr_empty_layer_ids = arg->nr_empty_layer_ids;
	__builtin_memcpy(nodec->empty_layer_ids, arg->empty_layer_ids,
			 sizeof(nodec->empty_layer_ids));

	if (arg->init) {
		nodec->nr_llcs = arg->nr_llcs;
		__builtin_memcpy(nodec->llcs, arg->llcs, sizeof(nodec->llcs));
	}

	return 0;
}

struct cached_cpus {
	s64			id;
	u64			seq;
};

struct task_ctx {
	int			pid;
	int			last_cpu;
	u32			layer_id;
	pid_t			last_waker;
	bool			refresh_layer;
	struct cached_cpus	layered_cpus;
	/*
	 * XXX: Old kernels can't track a bpf_cpumask on nested structs
	 */
	struct bpf_cpumask __kptr *layered_mask;
	struct cached_cpus	layered_cpus_llc;
	struct bpf_cpumask __kptr *layered_llc_mask;
	struct cached_cpus	layered_cpus_node;
	struct bpf_cpumask __kptr *layered_node_mask;
	struct cached_cpus	layered_cpus_unprotected;
	struct bpf_cpumask __kptr *layered_unprotected_mask;
	bool			all_cpus_allowed;
	bool			all_cpuset_cpus_allowed;
	bool			cpus_node_aligned;
	u32			pinned_node;
	u64			runnable_at;
	u64			running_at;
	u64			runtime_avg;
	u64			duty_cycle;	/* EWMA, 1.0 = 1 << DUTY_CYCLE_SHIFT */
	u64			last_stopped_at;
	u64			dsq_id;
	u32			llc_id;

	/* for llcc->queue_runtime */
	u32			qrt_layer_id;
	u32			qrt_llc_id;

	char 			join_layer[SCXCMD_COMLEN];
	u64			layer_refresh_seq;

	u64			recheck_layer_membership;
};

struct {
	__uint(type, BPF_MAP_TYPE_TASK_STORAGE);
	__uint(map_flags, BPF_F_NO_PREALLOC);
	__type(key, int);
	__type(value, struct task_ctx);
} task_ctxs SEC(".maps");


static void refresh_cpus_flags(struct task_ctx *taskc,
			       const struct cpumask *cpumask);

static struct task_ctx *lookup_task_ctx_may_fail(struct task_struct *p)
{
	return bpf_task_storage_get(&task_ctxs, p, 0, 0);
}

static struct task_ctx *lookup_task_ctx(struct task_struct *p)
{
	struct task_ctx *taskc = lookup_task_ctx_may_fail(p);

	if (!taskc)
		scx_bpf_error("task_ctx lookup failed");

	return taskc;
}

static struct task_hint *lookup_task_hint(struct task_struct *p)
{
	struct task_hint *hint;

	if (!task_hint_map_enabled)
		return NULL;
	hint = bpf_task_storage_get(&scx_layered_task_hint_map, p, NULL, 0);
	/* Only values in the range [0, 1024] are valid hints. */
	if (hint && hint->hint > 1024)
		hint = NULL;
	return hint;
}

static struct hint_layer_info *lookup_task_hint_layer_id(struct task_struct *p) {
	struct task_hint *hint;
	u32 hint_val;

	hint = lookup_task_hint(p);
	if (!hint)
		return NULL;

	hint_val = hint->hint;
	return bpf_map_lookup_elem(&hint_to_layer_id_map, &hint_val);
}

static void switch_to_layer(struct task_struct *, struct task_ctx *, u64 layer_id, u64 now);

static bool is_task_layer_hint_stale(struct task_struct *p, struct task_ctx *taskc)
{
	struct hint_layer_info *info;

	if (!task_hint_map_enabled)
		return false;

	info = lookup_task_hint_layer_id(p);
	if (!info)
		return false;
	return taskc->layer_id != info->layer_id;
}

static void maybe_refresh_task_layer_from_hint(struct task_struct *p, struct task_ctx *taskc)
{
	struct hint_layer_info *info;
	bool switch_layer = false;

	if (!task_hint_map_enabled)
		return;

	/* We are already going to refresh this task, skip. */
	if (taskc->refresh_layer)
		return;

	info = lookup_task_hint_layer_id(p);
	if (!info)
		return;

	/*
	 * We need to check whether the task layer matches the HintEquals specification,
	 * additionally qualified by predicates gating layer admission.
	 */
	if (taskc->layer_id != info->layer_id)
		switch_layer = true;

	if (info->system_cpu_util_below != (u64)-1) {
		if (system_cpu_util_ewma >= info->system_cpu_util_below) {
			/*
			 * Refresh task so that it gets evicted out. It only needs
			 * to be done for tasks in the current layer, for incoming
			 * tasks we just reject admission.
			 */
			taskc->refresh_layer = switch_layer == false;
			switch_layer = false;
		}
	}

	if (info->dsq_insert_below != (u64)-1 && taskc->layer_id < MAX_LAYERS) {
		if (layer_dsq_insert_ewma[taskc->layer_id] >= info->dsq_insert_below) {
			/* Same idea as above. */
			taskc->refresh_layer = switch_layer == false;
			switch_layer = false;
		}
	}

	/* All conditions satisfied for layer matching. */
	if (switch_layer)
		switch_to_layer(p, taskc, info->layer_id, scx_bpf_now());
}

int save_gpu_tgid_pid(void) {
	if (!enable_gpu_support)
		return 0;
	struct task_struct *p = NULL;
	struct task_ctx *taskc, *leader;
	u64 pid_tgid;
	u32 pid, tid;
	u64 timestamp = MEMBER_INVALID;

	pid_tgid = bpf_get_current_pid_tgid();
	pid = pid_tgid >> 32;
	tid = pid_tgid;

	if ((p = (struct task_struct*)bpf_get_current_task_btf()) && p) {
		if ((taskc = lookup_task_ctx_may_fail(p)) && taskc) {
			/* If it doesn't exist, recheck. If the timestamp is */
			if(!bpf_map_lookup_elem(&gpu_tid, &tid)) {
				trace("New GPU tid: %d, force to refresh layer", tid);
				taskc->refresh_layer = true;
			}

			/*
			 * GPU kprobe fire has expired for the member.
			 * Force a recheck to see if we should put it
			 * back into the GPU layer.
			 */
			if (taskc->recheck_layer_membership == MEMBER_EXPIRED)
				taskc->refresh_layer = true;

			timestamp = taskc->running_at;
		}

		/*
		 * Refresh the group leader so UsedGpuPid + IsGroupLeader
		 * rules work. Note: this relies on p->group_leader, which
		 * is the main thread of the thread group (same tgid). If
		 * the GPU-accessing process was created via fork() rather
		 * than clone(CLONE_THREAD)/pthread_create(), it will be
		 * its own group leader and the parent process will not be
		 * refreshed — so IsGroupLeader matching on the parent
		 * will not work in that case.
		 */
		if ((leader = lookup_task_ctx_may_fail(p->group_leader))) {
			if(!bpf_map_lookup_elem(&gpu_tgid, &pid)) {
				trace("New GPU pid: %d, force to refresh layer", pid);
				leader->refresh_layer = true;
			}

			if (leader->recheck_layer_membership == MEMBER_EXPIRED)
				leader->refresh_layer = true;
		}
	}
	bpf_map_update_elem(&gpu_tid, &tid, &timestamp, BPF_ANY);
	bpf_map_update_elem(&gpu_tgid, &pid, &timestamp, BPF_ANY);
	return 0;
}

SEC("?kprobe/nvidia_poll")
int kprobe_nvidia_poll(void) {
	return save_gpu_tgid_pid();
}

SEC("?kprobe/nvidia_open")
int kprobe_nvidia_open(void) {
	return save_gpu_tgid_pid();
}

SEC("?kprobe/nvidia_mmap")
int kprobe_nvidia_mmap(void) {
	return save_gpu_tgid_pid();
}

/*
 * Because the layer membership is by the default hierarchy cgroups rather than
 * the CPU controller membership, we can't use ops.cgroup_move(). Let's iterate
 * the tasks manually and set refresh_layer.
 *
 * The iteration isn't synchronized and may fail spuriously. It's not a big
 * practical problem as process migrations are very rare in most modern systems.
 * That said, we eventually want this to be based on CPU controller membership.
 */
SEC("tp_btf/cgroup_attach_task")
int BPF_PROG(tp_cgroup_attach_task, struct cgroup *cgrp, const char *cgrp_path,
	     struct task_struct *leader, bool threadgroup)
{
	struct list_head *thread_head;
	struct task_struct *next;
	struct task_ctx *taskc;

	if (!(taskc = lookup_task_ctx_may_fail(leader)))
		return 0;
	taskc->refresh_layer = true;

	if (!threadgroup)
		return 0;

	thread_head = &leader->signal->thread_head;

	if (!(next = bpf_task_acquire(leader))) {
		scx_bpf_error("failed to acquire leader");
		return 0;
	}

	bpf_repeat(MAX_TASKS) {
		struct task_struct *p;
		int pid;

		p = container_of(next->thread_node.next, struct task_struct, thread_node);
		bpf_task_release(next);

		if (&p->thread_node == thread_head) {
			next = NULL;
			break;
		}

		pid = BPF_CORE_READ(p, pid);
		next = bpf_task_from_pid(pid);
		if (!next) {
			bpf_printk("scx_layered: tp_cgroup_attach_task: thread iteration failed");
			break;
		}

		if ((taskc = lookup_task_ctx(next)))
			taskc->refresh_layer = true;
	}

	if (next)
		bpf_task_release(next);
	return 0;
}

static int handle_cmd(struct task_ctx *taskc, struct scx_cmd *cmd)
{

	_Static_assert(sizeof(*cmd) == MAX_COMM, "scx_cmd has wrong size");

	/* Is this a valid command? */
	if (cmd->prefix != SCXCMD_PREFIX)
		return 0;

	switch (cmd->opcode) {
	case SCXCMD_OP_NONE:
		break;

	case SCXCMD_OP_JOIN:
		__builtin_memcpy(taskc->join_layer, cmd->cmd, SCXCMD_COMLEN);
		break;

	case SCXCMD_OP_LEAVE:
		__builtin_memset(taskc->join_layer, 0, SCXCMD_COMLEN);
		break;

	default:
		break;
	}

	return 0;
}


SEC("tp_btf/task_rename")
int BPF_PROG(tp_task_rename, struct task_struct *p, const char *buf)
{
	struct task_ctx *taskc;
	struct scx_cmd cmd;
	int ret;

	if (!(taskc = lookup_task_ctx_may_fail(p))) {
		bpf_printk("could not find task on rename");
		return -EINVAL;
	}

	taskc->refresh_layer = true;

	ret = bpf_probe_read_str(&cmd, sizeof(cmd), buf);
	if (ret < 0) {
		bpf_printk("could not new task name on rename");
		return -EINVAL;
	}

	handle_cmd(taskc, &cmd);

	return 0;
}

/*
 * Initializes the scheduler to support running in a pid namespace.
 */
SEC("syscall")
int BPF_PROG(initialize_pid_namespace)
{
	struct task_struct *p;

	if (!(p = (struct task_struct*)bpf_get_current_task_btf()))
		return -ENOENT;

	layered_root_tgid = BPF_PROBE_READ(p, tgid);
	trace("CFG layered running with tgid: %d", layered_root_tgid);

	return 0;
}

static bool should_refresh_cached_cpus(struct cached_cpus *ccpus, s64 id, u64 cpus_seq)
{
	return ccpus->id != id || ccpus->seq != cpus_seq;
}

static __always_inline
void refresh_cached_cpus(struct bpf_cpumask *mask,
			 struct cached_cpus *ccpus,
			 s64 id, u64 cpus_seq,
			 const struct cpumask *cpus_a,
			 const struct cpumask *cpus_b)
{
	if (unlikely(!mask || !cpus_a || !cpus_b)) {
		scx_bpf_error("NULL ccpus->mask or cpus_a/b");
		return;
	}

	/*
	 * XXX - We're assuming that the updated @layer_cpumask matching the new
	 * @layer_seq is visible which may not be true. For now, leave it as-is.
	 * Let's update once BPF grows enough memory ordering constructs.
	 */
	bpf_cpumask_and(mask, cpus_a, cpus_b);
	ccpus->id = id;
	ccpus->seq = cpus_seq;
}

static void maybe_refresh_layered_cpus(struct task_struct *p, struct task_ctx *taskc,
				       const struct cpumask *layer_cpumask,
				       u64 cpus_seq)
{
	if (should_refresh_cached_cpus(&taskc->layered_cpus, 0, cpus_seq)) {
		refresh_cached_cpus(taskc->layered_mask, &taskc->layered_cpus, 0, cpus_seq,
				    p->cpus_ptr, layer_cpumask);
		trace("%s[%d] layered cpumask refreshed to seq=%llu",
		      p->comm, p->pid, taskc->layered_cpus.seq);
	}
}

static void maybe_refresh_layered_cpus_llc(struct task_struct *p, struct task_ctx *taskc,
					   const struct cpumask *layer_cpumask,
					   s32 llc_id, u64 cpus_seq)
{
	if (should_refresh_cached_cpus(&taskc->layered_cpus_llc, llc_id, cpus_seq)) {
		struct llc_ctx *llcc;

		if (!(llcc = lookup_llc_ctx(llc_id)))
			return;
		refresh_cached_cpus(taskc->layered_llc_mask,
				    &taskc->layered_cpus_llc, llc_id, cpus_seq,
				    cast_mask(taskc->layered_mask),
				    cast_mask(llcc->cpumask));
		trace("%s[%d] layered llc cpumask refreshed to llc=%d seq=%llu",
		      p->comm, p->pid, taskc->layered_cpus_llc.id, taskc->layered_cpus_llc.seq);
	}
}

static void maybe_refresh_layered_cpus_node(struct task_struct *p, struct task_ctx *taskc,
					    const struct cpumask *layer_cpumask,
					    s32 node_id, u64 cpus_seq)
{
	if (should_refresh_cached_cpus(&taskc->layered_cpus_node, node_id, cpus_seq)) {
		struct node_ctx *nodec;

		if (!(nodec = lookup_node_ctx(node_id)))
			return;
		refresh_cached_cpus(taskc->layered_node_mask,
				    &taskc->layered_cpus_node, node_id, cpus_seq,
				    cast_mask(taskc->layered_mask),
				    cast_mask(nodec->cpumask));
		trace("%s[%d] layered node cpumask refreshed to node=%d seq=%llu",
		      p->comm, p->pid, taskc->layered_cpus_node.id, taskc->layered_cpus_node.seq);
	}
}

static void maybe_refresh_layered_cpus_unprotected(struct task_struct *p, struct task_ctx *taskc,
		const struct cpumask *layer_cpumask)
{
	struct bpf_cpumask *task_cpumask = taskc->layered_unprotected_mask;
	u64 cpus_seq = READ_ONCE(unprotected_seq);

	/* Do we have our own unprotected CPU mask? */
	if (!task_cpumask || !layer_cpumask || !unprotected_cpumask)
		return;

	if (should_refresh_cached_cpus(&taskc->layered_cpus_unprotected, 0, cpus_seq)) {
		bpf_cpumask_or(task_cpumask, cast_mask(unprotected_cpumask), layer_cpumask);
		bpf_cpumask_and(task_cpumask, cast_mask(task_cpumask), p->cpus_ptr);

		taskc->layered_cpus_unprotected.id = 0;
		taskc->layered_cpus_unprotected.seq = cpus_seq;

		trace("%s[%d] layered allowed cpumask refreshed to seq=%llu",
		      p->comm, p->pid, taskc->layered_cpus_unprotected.seq);
	}
}

static __always_inline bool xnuma_is_mig_src(u32 layer_id, u32 nid)
{
	bool *is_src = MEMBER_VPTR(layers, [layer_id].node[nid].xnuma_is_mig_src);
	return is_src && *is_src;
}

static struct xnuma_bucket *xnuma_bucket_refill(u32 layer_id, u32 src_nid,
						 u32 dst_nid)
{
	struct xnuma_bucket *bucket;
	u64 now, elapsed;
	s64 refill, max_tokens;

	bucket = MEMBER_VPTR(layers, [layer_id].node[src_nid].xnuma[dst_nid]);
	if (!bucket || !bucket->rate || bucket->rate == (u64)-1)
		return NULL;

	now = scx_bpf_now();
	elapsed = now - bucket->last_refill_ts;
	if (elapsed > 1000000000ULL)
		elapsed = 1000000000ULL;

	refill = (s64)(bucket->rate * elapsed / 1000000000ULL);
	max_tokens = (s64)bucket->rate;	/* cap at 1 second worth */
	bucket->tokens += refill;
	if (bucket->tokens > max_tokens)
		bucket->tokens = max_tokens;
	bucket->last_refill_ts = now;

	return bucket;
}

/*
 * Check whether a cross-NUMA migration is allowed for this (layer, src, dst)
 * direction. rate semantics: U64_MAX = infinite (gating off, always allow),
 * 0 = zero budget (always deny), other = token bucket rate.
 * Does NOT deduct budget — use xnuma_gate_charge() in layered_running()
 * when the migration actually happens.
 */
static bool xnuma_gate(u32 layer_id, u32 src_nid, u32 dst_nid, s64 cost)
{
	struct xnuma_bucket *bucket;

	if (src_nid == dst_nid || src_nid >= MAX_NUMA_NODES ||
	    dst_nid >= MAX_NUMA_NODES)
		return true;

	bucket = MEMBER_VPTR(layers, [layer_id].node[src_nid].xnuma[dst_nid]);
	if (!bucket)
		return true;
	if (bucket->rate == (u64)-1)
		return true;	/* infinite budget → gating off */
	if (!bucket->rate)
		return false;	/* zero budget → deny */

	/* Fast path: budget covers cost, skip refill */
	if (bucket->tokens >= cost)
		return true;

	/* Slow path: refill and recheck */
	xnuma_bucket_refill(layer_id, src_nid, dst_nid);
	return bucket->tokens >= cost;
}

/*
 * Charge a completed cross-NUMA migration against the token bucket.
 * Called from layered_running() when a task actually starts running
 * on a different node than its previous CPU. No refill here — the next
 * xnuma_gate() call will refill if needed.
 */
static void xnuma_gate_charge(u32 layer_id, u32 src_nid, u32 dst_nid,
			      u64 duty_cycle)
{
	struct xnuma_bucket *bucket;

	if (src_nid == dst_nid || src_nid >= MAX_NUMA_NODES ||
	    dst_nid >= MAX_NUMA_NODES)
		return;

	bucket = MEMBER_VPTR(layers, [layer_id].node[src_nid].xnuma[dst_nid]);
	if (!bucket || !bucket->rate || bucket->rate == (u64)-1)
		return;

	bucket->tokens -= (s64)duty_cycle;
}

static s32 pick_idle_cpu_from(const struct cpumask *cand_cpumask, s32 prev_cpu,
			      const struct cpumask *idle_smtmask, const struct layer *layer)
{
	bool prev_in_cand;
	s32 i, cpu = -1;

	if (unlikely(!cand_cpumask || !idle_smtmask))
		return -1;

	prev_in_cand = bpf_cpumask_test_cpu(prev_cpu, cand_cpumask);

	/*
	 * If CPU has SMT, any wholly idle CPU is likely a better pick than
	 * partially idle @prev_cpu.
	 */
	if (smt_enabled) {
		// try prev if prev_over_idle_core
		if (prev_in_cand &&
			layer->prev_over_idle_core) {
			if (scx_bpf_test_and_clear_cpu_idle(prev_cpu))
				return prev_cpu;
			prev_in_cand = false;
		}

		// try prev if smt sibling empty
		if (prev_in_cand && bpf_cpumask_test_cpu(prev_cpu, idle_smtmask)) {
			if (scx_bpf_test_and_clear_cpu_idle(prev_cpu))
				return prev_cpu;
			prev_in_cand = false;
		}

		// try any idle core
		cpu = scx_bpf_pick_idle_cpu(cand_cpumask, SCX_PICK_IDLE_CORE);
		if (cpu >= 0)
			return cpu;

		if (nr_excl_layers && layer->excl)
			return -EBUSY;
	}

	bpf_for(i, 0, nr_cpu_ids) {
		struct cpu_ctx *sib_cpuc;
		s32 sib;

		// try prev if not tried yet and then pick any idle CPU
		if (prev_in_cand && scx_bpf_test_and_clear_cpu_idle(prev_cpu)) {
			cpu = prev_cpu;
			prev_in_cand = false;
		} else {
			cpu = scx_bpf_pick_idle_cpu(cand_cpumask, 0);
			if (cpu < 0)
				break;
		}

		// continue the search if the sibling is exclusive
		if (!nr_excl_layers ||
		    (sib = sibling_cpu(cpu)) < 0 || !(sib_cpuc = lookup_cpu_ctx(sib)) ||
		    (!sib_cpuc->current_excl && !sib_cpuc->next_excl))
			break;
	}

	return cpu;
}

static __always_inline
bool should_try_preempt_first(s32 cand, struct layer *layer,
			      const struct cpumask *layered_cpumask)
{
	struct cpu_ctx *cand_cpuc, *sib_cpuc;
	s32 sib;

	if (!layer->preempt || !layer->preempt_first)
		return false;

	if (layer->kind == LAYER_KIND_CONFINED &&
	    !bpf_cpumask_test_cpu(cand, layered_cpumask))
		return false;

	if (!(cand_cpuc = lookup_cpu_ctx(cand)) || cand_cpuc->current_preempt)
		return false;

	if (nr_excl_layers && layer->excl && (sib = sibling_cpu(cand)) >= 0 &&
	    (!(sib_cpuc = lookup_cpu_ctx(sib)) || sib_cpuc->current_preempt))
		return false;

	return true;
}

static __always_inline
s32 pick_idle_big_little(struct layer *layer, struct task_ctx *taskc,
			 const struct cpumask *idle_smtmask, s32 prev_cpu)
{
	s32 cpu = -1;

	if (!has_little_cores || !big_cpumask)
		return cpu;

	struct bpf_cpumask *tmp_cpumask __free(bpf_cpumask) = NULL;
	if (!taskc->layered_mask || !big_cpumask)
		return cpu;

	if (!(tmp_cpumask = bpf_cpumask_create()))
		return cpu;

	switch (layer->growth_algo) {
	case GROWTH_ALGO_BIG_LITTLE: {
		if (!taskc->layered_mask || !big_cpumask)
			return cpu;

		bpf_cpumask_and(tmp_cpumask, cast_mask(taskc->layered_mask),
				cast_mask(big_cpumask));
		cpu = pick_idle_cpu_from(cast_mask(tmp_cpumask),
					 prev_cpu, idle_smtmask, layer);
		return cpu;
	}
	case GROWTH_ALGO_LITTLE_BIG: {
		bpf_cpumask_setall(tmp_cpumask);
		if (!tmp_cpumask || !big_cpumask)
			return cpu;
		bpf_cpumask_xor(tmp_cpumask, cast_mask(big_cpumask),
				cast_mask(tmp_cpumask));
		if (!tmp_cpumask || !taskc->layered_mask)
			return cpu;
		bpf_cpumask_and(tmp_cpumask, cast_mask(taskc->layered_mask),
				cast_mask(tmp_cpumask));
		cpu = pick_idle_cpu_from(cast_mask(tmp_cpumask),
					 prev_cpu, idle_smtmask, layer);
		return cpu;
	}
	default:
		return cpu;
	}
}

static __always_inline
s32 pick_idle_cpu(struct task_struct *p, s32 prev_cpu,
		  struct cpu_ctx *cpuc, struct task_ctx *taskc, struct layer *layer,
		  bool from_selcpu)
{
	const struct cpumask *layer_cpumask, *layered_cpumask, *cpumask;
	bool is_float = layer->task_place == PLACEMENT_FLOAT;
	struct bpf_cpumask *unprot_mask;
	struct cpu_ctx *prev_cpuc;
	u32 layer_id = layer->id;
	u64 cpus_seq;
	s32 cpu;

	if (layer_id >= MAX_LAYERS || !(layer_cpumask = lookup_layer_cpumask(layer_id)))
		return -1;

	if (layer->periodically_refresh && taskc->layer_refresh_seq < layer_refresh_seq_avgruntime)
		taskc->refresh_layer = true;

	/*
	 * Not much to do if bound to a single CPU. Explicitly handle migration
	 * disabled tasks for kernels before SCX_OPS_ENQ_MIGRATION_DISABLED.
	 */
	if (!is_float && (p->nr_cpus_allowed == 1 || is_migration_disabled(p))) {
		if (scx_bpf_test_and_clear_cpu_idle(prev_cpu)) {
			if (layer->kind == LAYER_KIND_CONFINED &&
			    !bpf_cpumask_test_cpu(prev_cpu, layer_cpumask))
				lstat_inc(LSTAT_AFFN_VIOL, layer, cpuc);
			return prev_cpu;
		} else {
			return -1;
		}
	}

	cpus_seq = READ_ONCE(layers->cpus_seq);

	/*
	 * If @p prefers to preempt @prev_cpu than finding an idle CPU and
	 * @prev_cpu is preemptible, tell the enqueue path to try to preempt
	 * @prev_cpu. The enqueue path will also retry to find an idle CPU if
	 * the preemption attempt fails.
	 */
	maybe_refresh_layered_cpus(p, taskc, layer_cpumask, cpus_seq);
	if (!(layered_cpumask = cast_mask(taskc->layered_mask)))
		return -1;
	if (from_selcpu && should_try_preempt_first(prev_cpu, layer, layered_cpumask)) {
		cpuc->try_preempt_first = true;
		return -1;
	}

	/*
	 * When a layer stays saturated, there's no point in repeatedly
	 * searching for an idle CPU at different levels. Short-circuit by
	 * testing whether there are any eligible CPUs first.
	 */
	if (READ_ONCE(layer->check_no_idle)) {
		bool has_idle;
		const struct cpumask *idle_cpumask __free(idle_cpumask) = scx_bpf_get_idle_cpumask();

		if (layer->kind == LAYER_KIND_CONFINED) {
			has_idle = bpf_cpumask_intersects(layered_cpumask, idle_cpumask);
		} else {
			maybe_refresh_layered_cpus_unprotected(p, taskc, layered_cpumask);
			/*
			 * Use the task's idle unprotected mask if available, otherwise
			 * use the global one.
			 */
			unprot_mask = taskc->layered_unprotected_mask;
			if (!unprot_mask)
				unprot_mask = unprotected_cpumask;

			if (unlikely(!unprot_mask)) {
				scx_bpf_error("unprotected_cpumask not initialized");
				return -1;
			}

			has_idle = bpf_cpumask_intersects(cast_mask(unprot_mask), idle_cpumask);
		}

		if (!has_idle)
			return -1;
	}

	if ((nr_llcs > 1 || nr_nodes > 1) &&
	    !(prev_cpuc = lookup_cpu_ctx(prev_cpu)))
		return -1;

	const struct cpumask *idle_smtmask __free(idle_cpumask) = scx_bpf_get_idle_smtmask();
	if (!idle_smtmask)
		return -1;

	/*
	 * Grouped layers may opt to act like Confined for idle selection
	 * until the layer becomes saturated (check_no_idle is set) or
	 * the system is fully allocated (no free CPUs to grow into), at
	 * which point they fall back to searching unprotected CPUs.
	 *
	 * check_no_idle alone is too restrictive: CPUs degraded by
	 * softirq/IRQ overhead still appear briefly idle between bursts,
	 * keeping check_no_idle cleared even though the CPUs are
	 * effectively saturated.  fully_allocated lets userspace override
	 * when there's no room to grow.
	 */
	bool can_use_open = layer->kind != LAYER_KIND_CONFINED &&
		(!layer->idle_confined ||
		 READ_ONCE(layer->check_no_idle) ||
		 READ_ONCE(layer->fully_allocated));

	if (is_float)
		goto no_locality;

	/*
	 * If the system has a big/little architecture and uses any related
	 * layer growth algos try to find a cpu in that topology first.
	 */
	cpu = pick_idle_big_little(layer, taskc, idle_smtmask, prev_cpu);
	if (cpu >=0)
		goto out;

	/*
	 * Try a CPU in the previous LLC.
	 */
	if (nr_llcs > 1) {
		struct llc_ctx *prev_llcc;

		maybe_refresh_layered_cpus_llc(p, taskc, layer_cpumask,
					       prev_cpuc->llc_id, cpus_seq);
		if (!(cpumask = cast_mask(taskc->layered_llc_mask))) {
			cpu = -1;
			goto out;
		}
		if ((cpu = pick_idle_cpu_from(cpumask, prev_cpu, idle_smtmask, layer)) >= 0)
			goto out;

		if (!(prev_llcc = lookup_llc_ctx(prev_cpuc->llc_id)) ||
		    prev_llcc->queued_runtime[layer_id] < layer->xllc_mig_min_ns) {
			lstat_inc(LSTAT_XLLC_MIGRATION_SKIP, layer, cpuc);
			cpu = -1;
			goto out;
		}
	}

no_locality:
	/*
	 * Multi-node idle CPU search with NUMA gating.
	 *
	 * Two mask types are available:
	 *
	 * - Per-node masks (node_ctx->cpumask, ->unprotected_cpumask,
	 *   lookup_layer_node_cpumask()): raw topology masks, NOT
	 *   intersected with p->cpus_ptr. Safe only for tasks with
	 *   all_cpus_allowed. Used in the per-node prox walk.
	 *
	 * - Per-task cached masks (layered_mask, layered_node_mask,
	 *   layered_unprotected_mask): intersected with p->cpus_ptr
	 *   (layered_mask = layer_cpumask & cpus_ptr; others derived
	 *   from it). Safe for all tasks. Used as fallback.
	 *
	 * For all_cpus_allowed tasks on multi-node:
	 *  1. Layer CPUs on local node (per-task layered_node_mask)
	 *  2. Open CPUs on local node (per-node unprotected_cpumask)
	 *  3. Remote nodes in prox order, xnuma gated: layer then open
	 *
	 * Local open is cheaper than any NUMA crossing, so step 2 comes
	 * before remote layer CPUs in step 3.
	 *
	 * For !all_cpus_allowed or single-node, use per-task cached
	 * masks which respect p->cpus_ptr.
	 */
	if (nr_nodes > 1 && taskc->all_cpus_allowed) {
		bool is_open = can_use_open;
		u32 src_nid = prev_cpuc->node_id;
		struct node_ctx *src_nodec;
		s32 i;

		src_nodec = lookup_node_ctx(src_nid);
		if (!src_nodec)
			goto xnuma_done;

		/* Layer CPUs on local node */
		maybe_refresh_layered_cpus_node(p, taskc, layer_cpumask,
						src_nid, cpus_seq);
		if (!(cpumask = cast_mask(taskc->layered_node_mask))) {
			cpu = -1;
			goto out;
		}
		if ((cpu = pick_idle_cpu_from(cpumask, prev_cpu,
					     idle_smtmask, layer)) >= 0)
			goto out;

		/* Open CPUs on local node */
		if (is_open &&
		    (unprot_mask = src_nodec->unprotected_cpumask) &&
		    (cpu = pick_idle_cpu_from(cast_mask(unprot_mask),
					     prev_cpu, idle_smtmask,
					     layer)) >= 0) {
			lstat_inc(LSTAT_OPEN_IDLE, layer, cpuc);
			goto out;
		}

		/* Remote nodes in prox order, xnuma gated */
		if (!xnuma_is_mig_src(layer->id, src_nid))
			goto xnuma_done;
		bpf_for(i, 0, src_nodec->prox_map.sys_end) {
			const struct cpumask *node_cpumask;
			struct node_ctx *dst_nodec;
			u32 nid;

			if (i >= MAX_NUMA_NODES)
				break;
			nid = src_nodec->prox_map.nodes[i];

			if (nid == src_nid)
				continue;

			if (!xnuma_gate(layer->id, src_nid, nid,
					(s64)taskc->duty_cycle))
				continue;

			/* Layer CPUs on remote node */
			if ((node_cpumask = lookup_layer_node_cpumask(layer->id, nid)) &&
			    (cpu = pick_idle_cpu_from(node_cpumask, prev_cpu,
						     idle_smtmask, layer)) >= 0)
				goto out;

			/* Open CPUs on remote node */
			if (is_open &&
			    (dst_nodec = lookup_node_ctx(nid)) &&
			    (unprot_mask = dst_nodec->unprotected_cpumask) &&
			    (cpu = pick_idle_cpu_from(cast_mask(unprot_mask),
						     prev_cpu, idle_smtmask,
						     layer)) >= 0) {
				lstat_inc(LSTAT_OPEN_IDLE, layer, cpuc);
				goto out;
			}
		}
xnuma_done: ;
	} else {
		/*
		 * Single-node or restricted-affinity fallback. Uses per-task
		 * cached masks (cpus_ptr-intersected) so safe for all tasks.
		 */
		if (nr_nodes > 1) {
			maybe_refresh_layered_cpus_node(p, taskc, layer_cpumask,
							prev_cpuc->node_id,
							cpus_seq);
			if (!(cpumask = cast_mask(taskc->layered_node_mask))) {
				cpu = -1;
				goto out;
			}
			if ((cpu = pick_idle_cpu_from(cpumask, prev_cpu,
						     idle_smtmask, layer)) >= 0)
				goto out;
		}

		if ((cpu = pick_idle_cpu_from(layered_cpumask, prev_cpu,
					     idle_smtmask, layer)) >= 0)
			goto out;

		if (can_use_open) {
			maybe_refresh_layered_cpus_unprotected(p, taskc,
							       layered_cpumask);
			unprot_mask = taskc->layered_unprotected_mask;
			if (!unprot_mask)
				unprot_mask = unprotected_cpumask;

			if ((cpu = pick_idle_cpu_from(cast_mask(unprot_mask),
						     prev_cpu, idle_smtmask,
						     layer)) >= 0) {
				lstat_inc(LSTAT_OPEN_IDLE, layer, cpuc);
				goto out;
			}
		}
	}

	cpu = -1;

out:
	/*
	 * Update check_no_idle. Cleared if any idle CPU is found. Set if no
	 * idle CPU is found for a task without affinity restriction. Use
	 * READ/WRITE_ONCE() dance to avoid unnecessarily write-claiming the
	 * cacheline.
	 */
	if (cpu >= 0) {
		if (READ_ONCE(layer->check_no_idle))
			WRITE_ONCE(layer->check_no_idle, false);
	} else if (taskc->all_cpus_allowed) {
		if (!READ_ONCE(layer->check_no_idle))
			WRITE_ONCE(layer->check_no_idle, true);
	}

	return cpu;
}

static __always_inline
bool maybe_update_task_llc(struct task_struct *p, struct task_ctx *taskc, s32 new_cpu)
{
	u32 new_llc_id = cpu_to_llc_id(new_cpu);
	struct llc_ctx *prev_llcc, *new_llcc;
	u32 layer_id;
	s64 vtime_delta;

	if (taskc->llc_id == new_llc_id)
		return false;

	layer_id = taskc->layer_id;

	if (layer_id >= MAX_LAYERS ||
	    !(prev_llcc = lookup_llc_ctx(taskc->llc_id)) ||
	    !(new_llcc = lookup_llc_ctx(new_llc_id)))
		return false;

	vtime_delta = p->scx.dsq_vtime - prev_llcc->vtime_now[layer_id];
	p->scx.dsq_vtime = new_llcc->vtime_now[layer_id] + vtime_delta;

	taskc->llc_id = new_llc_id;
	return true;
}

s32 BPF_STRUCT_OPS(layered_select_cpu, struct task_struct *p, s32 prev_cpu, u64 wake_flags)
{
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	struct layer *layer;
	s32 cpu;

	maybe_refresh_layer_cpumasks();

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(p)))
		return prev_cpu;

	maybe_refresh_task_layer_from_hint(p, taskc);
	/*
	 * We usually update the layer in layered_runnable() to avoid confusion.
	 * As layered_select_cpu() takes place before runnable, new tasks would
	 * still have MAX_LAYERS layer. Just return @prev_cpu.
	 */
	if (taskc->layer_id == MAX_LAYERS || !(layer = lookup_layer(taskc->layer_id)))
		return prev_cpu;

	if (layer->task_place == PLACEMENT_STICK)
		cpu = prev_cpu;
	else
		cpu = pick_idle_cpu(p, prev_cpu, cpuc, taskc, layer, true);

	if (cpu >= 0) {
		lstat_inc(LSTAT_SEL_LOCAL, layer, cpuc);
		taskc->dsq_id = SCX_DSQ_LOCAL;
		scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, 0);
		return cpu;
	}

	return prev_cpu;
}

enum preempt_flags {
	PREEMPT_FIRST		= 1LLU << 0,
	PREEMPT_IGNORE_EXCL	= 1LLU << 1,
};

/*
 * XXX - It'd be better to get @cpuc and @enq_flags from the caller but that
 * goes beyond the maximum number of supported arguments and __always_inline
 * causes verification fail with "invalid size of register spill". Lookup cpuc
 * before use and ignore extra enq_flags.
 */
static bool try_preempt_cpu(s32 cand, struct task_struct *p, struct task_ctx *taskc,
			    struct layer *layer, u64 flags)
{
	struct cpu_ctx *cpuc, *cand_cpuc, *sib_cpuc = NULL;
	struct task_struct *curr;
	bool cand_idle;
	s32 sib;

	if (cand >= nr_possible_cpus || !bpf_cpumask_test_cpu(cand, p->cpus_ptr))
		return false;

	if (!(cand_cpuc = lookup_cpu_ctx(cand)))
		return false;

	if (cand_cpuc->preempting_task || cand_cpuc->current_preempt)
		return false;

	cand_idle = scx_bpf_test_and_clear_cpu_idle(cand);
	if (cand_idle)
		goto preempt;

	/*
	 * This racy check helps with reducing the incidence rate of preempting
	 * a CPU which already has tasks queued in its local DSQ. See the
	 * comment above preempting_task check.
	 */
	if (scx_bpf_dsq_nr_queued(SCX_DSQ_LOCAL_ON | cand))
		return false;

	scoped_guard(rcu) {
		curr = __COMPAT_scx_bpf_cpu_curr(cand);
		if (!curr)
			return false;

		if (ext_sched_class_addr && idle_sched_class_addr &&
		    ((u64)curr->sched_class != ext_sched_class_addr) &&
		    ((u64)curr->sched_class != idle_sched_class_addr)) {
			if (!(cpuc = lookup_cpu_ctx(-1)))
				return false;
			gstat_inc(GSTAT_SKIP_PREEMPT, cpuc);
			return false;
		}
	}

	/*
	 * Don't preempt if protection against is in effect. However, open
	 * layers share CPUs and using the same mechanism between non-preempt
	 * and preempt open layers doesn't make sense. Exclude for now.
	 */
	if (cand_cpuc->protect_owned_preempt && cand_cpuc->running_owned &&
	    !(layer->kind == LAYER_KIND_OPEN && cand_cpuc->running_open))
		return false;

	/*
	 * If exclusive, we want to make sure the sibling CPU, if there's
	 * one, is idle. However, if the sibling CPU is already running a
	 * preempt task, we shouldn't kick it out.
	 */
	if (nr_excl_layers && !(flags & PREEMPT_IGNORE_EXCL) &&
	    layer->excl && (sib = sibling_cpu(cand)) >= 0 &&
	    (!(sib_cpuc = lookup_cpu_ctx(sib)) || sib_cpuc->current_preempt)) {
		if (!(cpuc = lookup_cpu_ctx(-1)))
			return false;
		lstat_inc(LSTAT_EXCL_COLLISION, layer, cpuc);
		return false;
	}

preempt:
	/*
	 * Exclude other racing preemptors. While this significantly reduces the
	 * number of cases where multiple tasks target the same local DSQ
	 * simultaneously, it is still racy. e.g. The CPU might go idle between
	 * the preceding idle check and here and selcpu/enq path may directly
	 * dispatch to the CPU. We need kernel API updates to make this fully
	 * race-free.
	 */
	if (__sync_val_compare_and_swap(&cand_cpuc->preempting_task, NULL, p))
		return false;
	cand_cpuc->preempting_at = scx_bpf_now();

	/* preempt */
	taskc->dsq_id = SCX_DSQ_LOCAL_ON | cand;
	scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, SCX_ENQ_PREEMPT);

	if (!(cpuc = lookup_cpu_ctx(-1)))
		return true;

	const struct cpumask *idle_cpumask __free(idle_cpumask) = scx_bpf_get_idle_cpumask();

	/*
	 * $sib_cpuc is set if @p is an exclusive task, a sibling CPU
	 * exists which is not running a preempt task. Let's preempt the
	 * sibling CPU so that it can become idle. The ->maybe_idle test is
	 * inaccurate and racy but should be good enough for best-effort
	 * optimization.
	 */
	if (nr_excl_layers && sib_cpuc &&
	    !bpf_cpumask_test_cpu(sib_cpuc->cpu, idle_cpumask)) {
		lstat_inc(LSTAT_EXCL_PREEMPT, layer, cpuc);
		/*
		 * cpuc->current_excl will be set by running(); however, the
		 * sibling CPU might enter dispatch() before this CPU enters
		 * running(). Set cpuc->next_excl here.
		 */
		cpuc->next_excl = true;
		scx_bpf_kick_cpu(sib, SCX_KICK_PREEMPT);
	}

	if (cand_idle) {
		lstat_inc(LSTAT_PREEMPT_IDLE, layer, cpuc);
	} else {
		lstat_inc(LSTAT_PREEMPT, layer, cpuc);
		if (flags & PREEMPT_FIRST)
			lstat_inc(LSTAT_PREEMPT_FIRST, layer, cpuc);
		if (cand_cpuc->llc_id != cpuc->llc_id)
			lstat_inc(LSTAT_PREEMPT_XLLC, layer, cpuc);
		if (cand_cpuc->node_id != cpuc->node_id)
			lstat_inc(LSTAT_PREEMPT_XNUMA, layer, cpuc);
	}

	return true;
}

static void task_uncharge_qrt(struct task_ctx *taskc)
{
	struct llc_ctx *llcc;
	u32 layer_id = taskc->qrt_layer_id;

	if (layer_id >= MAX_LAYERS || !(llcc = lookup_llc_ctx(taskc->qrt_llc_id)))
		return;

	__sync_fetch_and_sub(&llcc->queued_runtime[layer_id], taskc->runtime_avg);
	taskc->qrt_layer_id = MAX_LAYERS;
	taskc->qrt_llc_id = MAX_LLCS;
}

static void layer_kick_idle_node_cpu(struct layer *layer, u32 node_id)
{
	const struct cpumask *node_cpumask;
	s32 cpu;

	if (!(node_cpumask = lookup_layer_node_cpumask(layer->id, node_id)))
		return;

	const struct cpumask *idle_smtmask __free(idle_cpumask) = scx_bpf_get_idle_smtmask();
	if (!idle_smtmask)
		return;

	if ((cpu = pick_idle_cpu_from(node_cpumask, 0,
				      idle_smtmask, layer)) >= 0)
		scx_bpf_kick_cpu(cpu, SCX_KICK_IDLE);
}

void BPF_STRUCT_OPS(layered_enqueue, struct task_struct *p, u64 enq_flags)
{
	struct cpu_ctx *cpuc, *task_cpuc;
	struct task_ctx *taskc;
	struct llc_ctx *llcc;
	struct layer *layer;
	bool wakeup = enq_flags & SCX_ENQ_WAKEUP;
	s32 cpu, task_cpu = scx_bpf_task_cpu(p);
	u32 llc_id, layer_id;
	bool yielding, try_preempt_first;
	u64 queued_runtime;
	u64 *lstats;

	maybe_refresh_layer_cpumasks();

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(p)))
		return;

	/* Only invoke if we never went through select_cpu path. */
	if (!__COMPAT_is_enq_cpu_selected(enq_flags))
		maybe_refresh_task_layer_from_hint(p, taskc);

	layer_id = taskc->layer_id;
	if (!(layer = lookup_layer(layer_id)))
		return;

	if (enq_flags & SCX_ENQ_REENQ) {
		lstat_inc(LSTAT_ENQ_REENQ, layer, cpuc);
	} else {
		if (wakeup)
			lstat_inc(LSTAT_ENQ_WAKEUP, layer, cpuc);
		else
			lstat_inc(LSTAT_ENQ_EXPIRE, layer, cpuc);
	}

	yielding = cpuc->yielding;
	if (yielding) {
		lstat_inc(LSTAT_YIELD, layer, cpuc);
		cpuc->yielding = false;
	}

	try_preempt_first = cpuc->try_preempt_first;
	cpuc->try_preempt_first = false;

	/*
	 * Does @p prefer to preempt its previous CPU even when there are other
	 * idle CPUs? If @p was already on the CPU (!wakeup), layered_dispatch()
	 * already decided that @p shouldn't continue running on it. Don't
	 * override the decision.
	 */
	if (try_preempt_first && wakeup && !yielding &&
	    try_preempt_cpu(task_cpu, p, taskc, layer, PREEMPT_FIRST))
		return;

	/*
	 * If select_cpu() was skipped, try direct dispatching to an idle CPU.
	 */
	if (!__COMPAT_is_enq_cpu_selected(enq_flags) || try_preempt_first) {
		cpu = pick_idle_cpu(p, task_cpu, cpuc, taskc, layer, false);
		if (cpu < 0)
			goto skip_ddsp;

		/* Non-confined layers can run anywhere. */
		if (layer->kind != LAYER_KIND_CONFINED)
			goto do_ddsp;

		struct cpu_ctx *target_cpuc = lookup_cpu_ctx(cpu);
		if (!target_cpuc)
			goto skip_ddsp;

		/* Confined layers are only scheduled on their own CPUs. */
		if (target_cpuc->layer_id != layer->id)
			goto skip_ddsp;
do_ddsp:

		lstat_inc(LSTAT_ENQ_LOCAL, layer, cpuc);
		taskc->dsq_id = SCX_DSQ_LOCAL_ON | cpu;
		scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, 0);
		return;
	}

skip_ddsp:

	if (!(task_cpuc = lookup_cpu_ctx(task_cpu)))
		return;

	/*
	 * No idle CPU, try preempting.
	 */
	if (layer->preempt && !yielding) {
		/*
		 * See try_preempt_first block above for explanation on the
		 * wakeup test.
		 */
		if (!try_preempt_first && wakeup &&
		    try_preempt_cpu(task_cpu, p, taskc, layer, 0))
			return;

		if (p->nr_cpus_allowed > 1) {
			struct cpu_prox_map *pmap = &task_cpuc->prox_map;
			u32 preempt_end = pmap->sys_end;

			/*
			 * Gate cross-NUMA preemption. Probe whether
			 * any remote node has budget. If all deny,
			 * stop the walk at the node boundary.
			 *
			 * No budget is deducted here — layered_running()
			 * charges the actual duty_cycle when the task
			 * starts on the preempted CPU.
			 */
			if (nr_nodes > 1) {
				u32 src_nid = task_cpuc->node_id;
				s32 nid;

				if (!xnuma_is_mig_src(layer->id, src_nid))
					goto preempt_xnuma_deny;

				bpf_for(nid, 0, nr_nodes) {
					if ((u32)nid == src_nid)
						continue;
					if (xnuma_gate(layer->id, src_nid, nid,
						       (s64)taskc->duty_cycle))
						goto preempt_xnuma_done;
				}

preempt_xnuma_deny:
				preempt_end = pmap->node_end;
preempt_xnuma_done: ;
			}

			bpf_for(cpu, 1, MAX_CPUS) {
				if (cpu >= preempt_end)
					break;
				u16 *cpu_p = MEMBER_VPTR(pmap->cpus, [cpu]);
				if (cpu_p && try_preempt_cpu(*cpu_p, p, taskc, layer, 0))
					return;
			}

			if (nr_excl_layers && layer->excl) {
				bpf_for(cpu, 0, MAX_CPUS) {
					if (cpu >= preempt_end)
						break;
					u16 *cpu_p = MEMBER_VPTR(pmap->cpus, [cpu]);
					if (cpu_p && try_preempt_cpu(*cpu_p, p, taskc, layer,
								     PREEMPT_IGNORE_EXCL))
						return;
				}
			}
		}

		lstat_inc(LSTAT_PREEMPT_FAIL, layer, cpuc);
	}

	/*
	 * Special-case per-cpu kthreads and scx_layered userspace so that they
	 * run before preempting layers. This is to guarantee timely execution
	 * of layered userspace code and give boost to per-cpu kthreads as they
	 * are usually important for system performance and responsiveness.
	 */
	if (((p->flags & PF_KTHREAD) && p->nr_cpus_allowed < nr_possible_cpus) ||
	    is_scheduler_task(p)) {
		struct cpumask *layer_cpumask;

		if (layer->kind == LAYER_KIND_CONFINED &&
		    (layer_cpumask = lookup_layer_cpumask(taskc->layer_id)) &&
		    !bpf_cpumask_test_cpu(task_cpu, layer_cpumask))
			lstat_inc(LSTAT_AFFN_VIOL, layer, cpuc);

		if (p->nr_cpus_allowed == 1) {
			taskc->dsq_id = SCX_DSQ_LOCAL;
			/*
			 * For scheduling latency, scx_layered usually depends
			 * on the fact that a task can be pulled by multiple
			 * CPUs and an eligible CPU is likely to open up soon.
			 * However, if @p is a high-priority per-cpu kthread, it
			 * has to run soon and can only run on one particular
			 * CPU. Preempt whatever is running on that CPU. This
			 * can be disabled by --disable-percpu-kthread-preempt.
			 */
			if (is_percpu_kthread_preempting(p))
				enq_flags |= SCX_ENQ_PREEMPT;
		} else {
			taskc->dsq_id = task_cpuc->hi_fb_dsq_id;
		}

		scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, enq_flags);
		return;
	}

	/*
	 * No idle CPU, no preemption, insert into the DSQ. First, update the
	 * associated LLC and limit the amount of budget that an idling task can
	 * accumulate to one slice.
	 */
	llc_id = task_cpuc->llc_id;
	if (llc_id >= MAX_LLCS || !(llcc = lookup_llc_ctx(llc_id)))
		return;

	/*
	 * If necessary, migrate @p to new LLC and constrain its vtime. As
	 * maybe_update_task_llc() can update @p->scx.dsq_vtime, it can only be
	 * read afterwards.
	 *
	 * A task is allowed to carry at most a slice worth of vtime budget
	 * which determines the minimum vtime. It shouldn't be necessary to cap
	 * the max vtime as there is no way for it to become significantly later
	 * than vtime_now; however, cap the max delta at 8192 times the slice
	 * just in case and log violations as there have been bugs in this area.
	 * 8192 came from 100x for min weight, 20x for typical max_exec_us, and
	 * ~4x for buffer.
	 */
	maybe_update_task_llc(p, taskc, task_cpu);

	u64 vtime = p->scx.dsq_vtime;
	u64 vtime_now = llcc->vtime_now[layer_id];
	u64 vtime_min = vtime_now - layer->slice_ns;
	u64 vtime_max = vtime_now + 8192 * layer->slice_ns;

	if (time_before(vtime, vtime_min))
		vtime = vtime_min;
	if (unlikely(time_after(vtime, vtime_max))) {
		gstat_inc(GSTAT_FIXUP_VTIME, cpuc);
		vtime = vtime_max;
	}

	/*
	 * Tasks with custom affinities or from empty layers can stall if put
	 * into layer DSQs. Put them into a low fallback DSQ which is guaranteed
	 * the lo_fb_share_ppk fraction of each CPU once the tasks have been
	 * queued on it longer than lo_fb_wait_ns.
	 *
	 * When racing against layer CPU allocation updates, tasks with full
	 * affinity may end up in the DSQs of an empty layer. They are handled
	 * by the per-node fallback CPUs.
	 *
	 * A task is safe on a layer DSQ if any of the following hold:
	 *
	 * - all_cpus_allowed: The task can run on all CPUs, so it can always
	 *   consume from any layer DSQ.
	 *
	 * - all_cpuset_cpus_allowed: The layer has a static cpuset and the
	 *   task covers it. Since cpuset masks don't change, the task can
	 *   always run on all CPUs the layer will ever use. Guaranteed to
	 *   be false for non-cpuset layers by refresh_cpus_flags().
	 *
	 * - cpus_node_aligned: The task's affinity covers whole NUMA nodes.
	 *   With per-node allocation, the layer will always have CPUs on
	 *   those nodes.
	 */
	if ((!taskc->all_cpus_allowed &&
	     !taskc->all_cpuset_cpus_allowed &&
	     !taskc->cpus_node_aligned) ||
	    !layer->nr_cpus) {
		// Special handle for thread that has affinity set, but need more CPU time.
		// XXX: If we need to support more than one thread (which is probably bad from
		// deterministic performance perspective), we can change this to a map later.
		if (enable_hi_fb_thread_name_match &&
				bpf_strncmp(p->comm, sizeof(p->comm), (const char *)hi_fb_thread_name) == 0) {
			trace("Put %s[%d] in hi_fb_dsq",
					hi_fb_thread_name, p->pid);
			taskc->dsq_id = task_cpuc->hi_fb_dsq_id;
		}
		else {
			taskc->dsq_id = task_cpuc->lo_fb_dsq_id;
		}
		/*
		 * Start a new lo fallback queued region if the DSQ is empty.
		 * While the following is racy, all that's needed is at least
		 * one of the racing updates to succeed, which is guaranteed.
		 */
		if (!scx_bpf_dsq_nr_queued(taskc->dsq_id))
			llcc->lo_fb_seq++;
		scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, enq_flags);
		return;
	}

	/*
	 * A task can be enqueued more than once before going through
	 * ops.running() if the task's property changes which dequeues and
	 * re-enqueues the task. The task does not go through ops.runnable()
	 * again in such cases, so layer association would remain the same.
	 *
	 * XXX: It'd be nice if ops.dequeue() could be used to adjust
	 * queued_runtime but ops.dequeue() is not called for tasks on a
	 * DSQ. Detect the condition here and subtract the previous
	 * contribution.
	 */
	task_uncharge_qrt(taskc);

	taskc->qrt_layer_id = layer_id;
	taskc->qrt_llc_id = llc_id;
	queued_runtime = __sync_fetch_and_add(&llcc->queued_runtime[layer_id],
					      taskc->runtime_avg);
	queued_runtime += taskc->runtime_avg;

	lstats = llcc->lstats[layer_id];

	/* racy, don't care */
	lstats[LLC_LSTAT_LAT] =
		((LAYER_LAT_DECAY_FACTOR - 1) * lstats[LLC_LSTAT_LAT] + queued_runtime) /
		LAYER_LAT_DECAY_FACTOR;
	lstats[LLC_LSTAT_CNT]++;

	taskc->dsq_id = layer_dsq_id(layer_id, llc_id);
	if (layer->fifo)
		scx_bpf_dsq_insert(p, taskc->dsq_id, layer->slice_ns, enq_flags);
	else
		scx_bpf_dsq_insert_vtime(p, taskc->dsq_id, layer->slice_ns, vtime, enq_flags);
	lstat_inc(LSTAT_ENQ_DSQ, layer, cpuc);

	/*
	 * Interlocked with refresh_cpumasks(). scx_bpf_dsq_insert[_vtime]()
	 * always goes through spin lock/unlock and has enough barriers to
	 * guarantee that either they see the task we enqueeud or we see zero
	 * nr_llc_cpus.
	 *
	 * Also interlocked with opportunistic disabling in
	 * try_drain_layer_node_llcs(). See there.
	 */
	if (!layer->nr_llc_cpus[llc_id]) {
		layer_llc_drain_enable(layer, llc_id);
		layer_kick_idle_node_cpu(layer, llc_node_id(llc_id));
	}
}

static inline void check_member_expired(struct task_ctx *taskc, u64 now)
{
	u64 recheck = taskc->recheck_layer_membership;

	/*
	 * Don't trigger a recheck if:
	 * - Membership never expires
	 * - Membership already expired
	 * - Member has been tested and hasn't joined any GPU layer
	 *   even though it matches the GPU rule.
	 */
	if (recheck == MEMBER_NOEXPIRE ||
		recheck == MEMBER_EXPIRED ||
		recheck == MEMBER_CANTMATCH)
		return;

	if (now >= taskc->recheck_layer_membership)
		taskc->refresh_layer = true;
}

static void account_used(struct task_struct *p, struct cpu_ctx *cpuc, struct task_ctx *taskc, u64 now)
{
	s32 task_lid;
	u64 used;
	u64 bytes;

	/* Try to get the memory bandwidth, actively ignore the error if we fail. */
	if (scx_pmu_read(p, membw_event, &bytes, true))
		bytes = 0;
	bytes *= 64;

	used = now - cpuc->used_at;
	if (!used)
		return;

	task_lid = taskc->layer_id;
	if (unlikely(task_lid >= nr_layers)) {
		scx_bpf_error("invalid layer %d", task_lid);
		return;
	}

	cpuc->used_at = now;
	cpuc->usage += used;

	check_member_expired(taskc, now);

	/*
	 * protect_owned/preempt accounting is a bit wrong in that they charge
	 * the execution duration to the layer that just ran which may be
	 * different from the layer that is protected on the CPU. Oh well...
	 */
	if (cpuc->running_owned) {
		cpuc->layer_usages[task_lid][LAYER_USAGE_OWNED] += used;
		cpuc->layer_membw_agg[task_lid][LAYER_USAGE_OWNED] += bytes;
		if (cpuc->protect_owned) {
			cpuc->layer_usages[task_lid][LAYER_USAGE_PROTECTED] += used;
			cpuc->layer_membw_agg[task_lid][LAYER_USAGE_PROTECTED] += bytes;
		}
		if (cpuc->protect_owned_preempt) {
			cpuc->layer_usages[task_lid][LAYER_USAGE_PROTECTED_PREEMPT] += used;
			cpuc->layer_membw_agg[task_lid][LAYER_USAGE_PROTECTED_PREEMPT] += bytes;
		}
	} else {
		cpuc->layer_usages[task_lid][LAYER_USAGE_OPEN] += used;
		cpuc->layer_membw_agg[task_lid][LAYER_USAGE_OPEN] += bytes;
	}

	if (taskc->pinned_node < MAX_NUMA_NODES)
		cpuc->node_pinned_usage[task_lid] += used;

	if (taskc->dsq_id & HI_FB_DSQ_BASE)
		gstat_add(GSTAT_HI_FB_USAGE, cpuc, used);
	else if (taskc->dsq_id & LO_FB_DSQ_BASE)
		gstat_add(GSTAT_LO_FB_USAGE, cpuc, used);

	if (cpuc->running_fallback)
		gstat_add(GSTAT_FB_CPU_USAGE, cpuc, used);
}

static bool keep_running(struct cpu_ctx *cpuc, struct task_struct *p,
			 struct task_ctx *taskc, struct layer *layer)
{
	if (cpuc->yielding || !max_exec_ns)
		goto no;

	/* Confined tasks must not keep running on a non-layer CPU */
	if (layer->kind == LAYER_KIND_CONFINED && cpuc->layer_id != layer->id)
		goto no;

	/* does it wanna? */
	if (!(p->scx.flags & SCX_TASK_QUEUED))
		goto no;

	/* tasks running in low fallback doesn't get to continue */
	if (taskc->dsq_id & LO_FB_DSQ_BASE)
		goto no;

	/* if hi_fb has tasks pending, don't keep running the current one */
	if (scx_bpf_dsq_nr_queued(cpuc->hi_fb_dsq_id))
		goto no;

	/* @p has fully consumed its slice and still wants to run */
	cpuc->ran_current_for += layer->slice_ns;

	/*
	 * There wasn't anything in the local or global DSQ, but there may be
	 * tasks which are affine to this CPU in some other DSQs. Let's not run
	 * for too long.
	 */
	if (cpuc->ran_current_for > max_exec_ns) {
		lstat_inc(LSTAT_KEEP_FAIL_MAX_EXEC, layer, cpuc);
		goto no;
	}

	/*
	 * @p is eligible for continuing. We need to implement a better way to
	 * determine whether a layer is allowed to keep running. For now,
	 * implement something simple.
	 */
	if (layer->preempt) {
		/*
		 * @p is in an preempting layer. As long as the layer doesn't
		 * have tasks waiting, keep running it. If there are multiple
		 * competing preempting layers, this won't work well.
		 */
		u64 dsq_id = layer_dsq_id(layer->id, cpuc->llc_id);
		if (!scx_bpf_dsq_nr_queued(dsq_id)) {
			p->scx.slice = layer->slice_ns;
			lstat_inc(LSTAT_KEEP, layer, cpuc);
			return true;
		}
	} else {
		const struct cpumask *idle_cpumask __free(idle_cpumask) = scx_bpf_get_idle_cpumask();
		bool has_idle = false;

		/*
		 * If @p is in an open layer, keep running if there's any idle
		 * CPU. If confined, keep running if and only if the layer has
		 * idle CPUs.
		 */
		if (layer->kind != LAYER_KIND_CONFINED) {
			has_idle = !bpf_cpumask_empty(idle_cpumask);
		} else {
			struct cpumask *layer_cpumask;

			if ((layer_cpumask = lookup_layer_cpumask(layer->id)))
				has_idle = bpf_cpumask_intersects(idle_cpumask,
								  layer_cpumask);
		}

		if (has_idle) {
			p->scx.slice = layer->slice_ns;
			lstat_inc(LSTAT_KEEP, layer, cpuc);
			return true;
		}
	}

	lstat_inc(LSTAT_KEEP_FAIL_BUSY, layer, cpuc);
no:
	cpuc->ran_current_for = 0;
	return false;
}

/* Mapping of cpu to most delayed DSQ it can consume */
struct {
	__uint(type, BPF_MAP_TYPE_PERCPU_ARRAY);
	__type(key, u32);
	__type(value, u64);
	__uint(max_entries, 1);
} antistall_cpu_dsq SEC(".maps");

/* Mapping cpu to delay of highest delayed DSQ it can consume */
struct {
	__uint(type, BPF_MAP_TYPE_PERCPU_ARRAY);
	__type(key, u32);
	__type(value, u64);
	__uint(max_entries, 1);
} antistall_cpu_max_delay SEC(".maps");

/**
 * get_delay_sec() - get runnable_at delay of a task_struct in seconds.
 * @p: task_struct *p
 * @jiffies_now: time from which to measure delay, in jiffies.
 *
 * Return: runnable_at delay, if any exists, in seconds.
 */
int get_delay_sec(struct task_struct *p, u64 jiffies_now)
{
	u64 runnable_at, delta_secs;
	runnable_at = READ_ONCE(p->scx.runnable_at);

	if (time_before(runnable_at, jiffies_now)) {
		delta_secs = (jiffies_now - runnable_at) / CONFIG_HZ;
	} else {
		delta_secs = 0;
	}

	return delta_secs;
}

/**
 * antistall_consume() - consume delayed DSQ
 * @cpuc: cpu context
 *
 * This function consumes a delayed DSQ. This is meant to be called
 * from dispatch, before any other logic which could result in a
 * DSQ being consumed.
 *
 * This is meant to prevent issues such as DSQs with affinitized tasks
 * stalling when all CPUs which can process them are continually consuming
 * other DSQs.
 *
 * Return: bool indicating if a DSQ was consumed or not.
 */
bool antistall_consume(struct cpu_ctx *cpuc)
{
	u64 *antistall_dsq, jiffies_now, cur_delay;
	bool consumed;
	struct task_struct *p;

	cur_delay = 0;
	consumed = false;

	if (!enable_antistall || !cpuc)
		return false;

	antistall_dsq = bpf_map_lookup_elem(&antistall_cpu_dsq, &zero_u32);

	if (!antistall_dsq) {
		scx_bpf_error("can't happen");
		return false;
	}

	if (*antistall_dsq == SCX_DSQ_INVALID)
		return false;

	consumed = scx_bpf_dsq_move_to_local(*antistall_dsq, 0);

	if (!consumed)
		goto reset;

	gstat_inc(GSTAT_ANTISTALL, cpuc);

	jiffies_now = bpf_jiffies64();

	bpf_for_each(scx_dsq, p, *antistall_dsq, 0) {
		cur_delay = get_delay_sec(p, jiffies_now);

		if (cur_delay > antistall_sec) {
			return consumed;
		}

		goto reset;
	}

reset:
	trace("antistall reset DSQ[%llu] SELECTED_CPU[%llu] DELAY[%llu]",
	      *antistall_dsq, cpuc->cpu, cur_delay);
	*antistall_dsq = SCX_DSQ_INVALID;
	return consumed;
}

static bool try_drain_layer_node_llcs(struct layer *layer, struct cpu_ctx *cpuc)
{
	u32 nid = cpuc->node_id;
	struct node_ctx *nodec;
	struct layer_node_ctx *lnc;
	u32 cnt, nr, u;

	if (nid >= MAX_NUMA_NODES)
		return false;

	nodec = lookup_node_ctx(nid);
	if (!nodec)
		return false;

	lnc = &layer->node[nid];
	cnt = lnc->llc_drain_cnt++;
	nr = nodec->nr_llcs;

	/* alternate between prioritizing draining and owned */
	if (cnt & 1)
		return false;

	lstat_inc(LSTAT_LLC_DRAIN_TRY, layer, cpuc);

	bpf_for(u, 0, nr) {
		u32 idx = (u + cnt / 2) % nr;
		u32 *llc_ptr = MEMBER_VPTR(nodec->llcs, [idx]);
		u32 llc_id;
		u64 dsq_id;
		u32 *vptr;
		bool disabled = false, consumed;

		if (!llc_ptr)
			break;
		llc_id = *llc_ptr;
		dsq_id = layer_dsq_id(layer->id, llc_id);

		if (!(lnc->llcs_to_drain & (1LLU << llc_id)))
			continue;

		if ((vptr = MEMBER_VPTR(layer->nr_llc_cpus, [llc_id])) && *vptr)
			continue;

		/*
		 * Draining is relatively expensive and we want to turn it off
		 * as soon as possible. However, we can't turn it off after
		 * consuming as we can race against enabling and end up turning
		 * off draining and leave the new task in the unserviced DSQ.
		 *
		 * Instead, turn it off if it's likely that the DSQ is going to
		 * be empty after consuming and re-enable afterwards if
		 * necessary to guarantee that draining never stays disabled
		 * with tasks in the DSQ.
		 */
		if (scx_bpf_dsq_nr_queued(dsq_id) <= 1) {
			layer_llc_drain_disable(layer, llc_id);
			disabled = true;
		}

		consumed = scx_bpf_dsq_move_to_local(dsq_id, 0);

		/*
		 * Interlocked with enabling in layered_enqueue(). Either we see
		 * increased nr_queued or they see disable and re-enable. Note
		 * that we can race against nr_llc_cpus update or other draining
		 * CPUs and re-enable unnecessarily. Doesn't matter. Will be
		 * re-tried on the next draining attempt.
		 */
		if (disabled && scx_bpf_dsq_nr_queued(dsq_id))
			layer_llc_drain_enable(layer, llc_id);

		if (consumed) {
			lstat_inc(LSTAT_LLC_DRAIN, layer, cpuc);
			return true;
		}
	}

	return false;
}

static __always_inline bool try_consume_layer(u32 layer_id, struct cpu_ctx *cpuc,
					      struct llc_ctx *llcc,
					      bool rescue_stranded)
{
	/*
	 * Select random proximity map from NUM_PROXIMITY_MAPS to avoid
	 * bias in proximity map ordering of LLCs with same locality.
	 */
	u32 pmap_idx = bpf_get_prandom_u32() % NUM_PROXIMITY_MAPS;
	struct llc_prox_map *llc_pmap = &llcc->prox_maps[pmap_idx];
	struct layer *layer;
	u32 nid = llc_node_id(llcc->id);
	bool xllc_mig_skipped = false;
	bool skip_remote_node;
	u32 u;

	if (!(layer = lookup_layer(layer_id)))
		return false;

	/*
	 * If a layer is confined, and the CPU doesn't belong to it, we
	 * shouldn't consume from it — unless rescue_stranded is set,
	 * which indicates fallback draining of stranded tasks on nodes
	 * where the layer has no CPUs.
	 */
	if (!rescue_stranded &&
	    layer->kind == LAYER_KIND_CONFINED && cpuc->layer_id != layer_id)
		return false;

	skip_remote_node = layer->skip_remote_node;

	bpf_for(u, 0, llc_pmap->sys_end) {
		u16 *llc_idp;

		if (!(llc_idp = MEMBER_VPTR(llc_pmap->llcs, [u]))) {
			scx_bpf_error("llc_pmap->sys_end=%u too big", llc_pmap->sys_end);
			return false;
		}

		if (u > 0) {
			struct llc_ctx *remote_llcc;
			u32 remote_nid;

			if (!(remote_llcc = lookup_llc_ctx(*llc_idp)))
				return false;

			remote_nid = llc_node_id(remote_llcc->id);

			if (skip_remote_node && nid != remote_nid) {
				lstat_inc(LSTAT_SKIP_REMOTE_NODE, layer, cpuc);
				continue;
			}

			if (remote_llcc->queued_runtime[layer_id] < layer->xllc_mig_min_ns) {
				xllc_mig_skipped = true;
				continue;
			}

			/*
			 * Gate cross-NUMA consumption. Budget is not
			 * deducted here — layered_running() charges
			 * the actual task's duty_cycle when the pulled
			 * task starts running on this CPU.
			 */
			if (nid != remote_nid &&
			    (!xnuma_is_mig_src(layer_id, remote_nid) ||
			     !xnuma_gate(layer_id, remote_nid, nid, 0))) {
				/*
				 * On 2-node systems, there's only one
				 * remote node — no point continuing.
				 */
				if (nr_nodes <= 2)
					break;
				continue;
			}
		}

		/*
		 * Re-verify layer_id range after xnuma_gate() subprog
		 * call — verifiers before 6.19 lose scalar bounds
		 * across non-inline function calls.  Can be removed
		 * once the minimum supported kernel is >= 6.19.
		 */
		if (layer_id >= nr_layers)
			return false;

		if (scx_bpf_dsq_move_to_local(layer_dsq_id(layer_id, *llc_idp), 0))
			return true;
	}

	if (xllc_mig_skipped)
		lstat_inc(LSTAT_XLLC_MIGRATION_SKIP, layer, cpuc);

	return false;
}

static __always_inline
bool try_consume_layers(u32 *layer_order, u32 nr, u32 exclude_layer_id,
			struct cpu_ctx *cpuc, struct llc_ctx *llcc,
			bool rescue_stranded)
{
	u32 u;

	if (nr >= MAX_LAYERS) {
		scx_bpf_error("nr=%u too high", nr);
		return false;
	}

	bpf_for(u, 0, nr) {
		u32 layer_id = layer_order[u];

		if (layer_id == exclude_layer_id)
			continue;

		if (try_consume_layer(layer_id, cpuc, llcc, rescue_stranded))
			return true;
	}

	return false;
}

bool __always_inline sib_keep_idle(s32 cpu, struct task_struct *prev __arg_trusted, struct layer *prev_layer,
				   struct task_ctx *prev_taskc, struct cpu_ctx *cpuc)
{

	/*
	 * If the sibling CPU is running an exclusive task, keep this CPU idle
	 * unless @prev is also runnable and exclusive.
	 */
	if (nr_excl_layers && (!prev_taskc || !prev_layer->excl)) {
		struct cpu_ctx *sib_cpuc;
		s32 sib;

		if ((sib = sibling_cpu(cpu)) >= 0 && (sib_cpuc = lookup_cpu_ctx(sib)) &&
		    (sib_cpuc->current_excl || sib_cpuc->next_excl)) {
			gstat_inc(GSTAT_EXCL_IDLE, cpuc);
			return true;
		}
	}

	return false;
}

void BPF_STRUCT_OPS(layered_dispatch, s32 cpu, struct task_struct *prev)
{
	struct task_ctx *prev_taskc = NULL;
	struct layer *prev_layer = NULL;
	struct cpu_ctx *cpuc;
	struct llc_ctx *llcc;
	bool tried_preempting = false, tried_lo_fb = false;
	u32 nr_ogp_layers = nr_op_layers + nr_gp_layers;
	u32 nr_ogn_layers = nr_on_layers + nr_gn_layers;

	maybe_refresh_layer_cpumasks();

	if (!(cpuc = lookup_cpu_ctx(-1)))
		return;

	if (antistall_consume(cpuc))
		return;

	/* !NULL prev_taskc indicates runnable prev */
	if (prev && (prev->scx.flags & SCX_TASK_QUEUED)) {
		if (!(prev_taskc = lookup_task_ctx(prev)) ||
		    !(prev_layer = lookup_layer(prev_taskc->layer_id)))
			return;
	}

	if (prev && sib_keep_idle(cpu, prev, prev_layer, prev_taskc, cpuc))
		return;

	/*
	 * if @prev was on SCX and is still runnable, we are here because @prev
	 * has exhausted its slice. We may want to keep running it on this CPU
	 * rather than giving this CPU to another task and then try to schedule
	 * @prev somewhere else.
	 *
	 * Let's not dispatch any task if we want to keep running @prev. This
	 * will trigger the automatic local enq behavior which will put @prev on
	 * @cpu's local DSQ. A more straightforward way to implement this would
	 * be extending slice from ops.tick() but that's not available in older
	 * kernels, so let's make do with this for now.
	 */
	if (prev_taskc && keep_running(cpuc, prev, prev_taskc, prev_layer)) {
		/*
		 * Do not refresh the slice in case we need the task to be reenqueued
		 * for layer membership change and subsequent CPU selection.
		 */
		if (is_task_layer_hint_stale(prev, prev_taskc))
			return;
		prev->scx.slice = prev_layer->slice_ns;
		return;
	}

	if (!(llcc = lookup_llc_ctx(cpuc->llc_id)))
		return;

	/* always consume hi_fb_dsq_id first for kthreads */
	if (scx_bpf_dsq_move_to_local(cpuc->hi_fb_dsq_id, 0))
		return;

	/*
	 * Per-node fallback: service layers that have no CPUs on this node.
	 * Tasks can be stranded in this node's LLC DSQs for a layer that has
	 * no local CPUs to service them.
	 */
	struct node_ctx *nodec;
	if (cpuc->node_id < MAX_NUMA_NODES &&
	    cpuc->cpu == fallback_cpus[cpuc->node_id] &&
	    (nodec = lookup_node_ctx(cpuc->node_id)) &&
	    try_consume_layers(nodec->empty_layer_ids,
			       nodec->nr_empty_layer_ids,
			       MAX_LAYERS, cpuc, llcc, true)) {
		trace("FALLBACK cpu=%d node=%d (node_cpus=0)",
		      cpuc->cpu, cpuc->node_id);
		cpuc->running_fallback = true;
		return;
	}

	/*
	 * Low fallback DSQ execution is forced upto lo_fb_share_ppk fraction
	 * after the DSQ had tasks queued for longer than lo_fb_wait_ns.
	 */
	if (scx_bpf_dsq_nr_queued(cpuc->lo_fb_dsq_id)) {
		u64 now = scx_bpf_now();
		u64 dur, usage;

		/*
		 * llcc->lo_fb_seq is bumped whenever the low fallback DSQ
		 * transitions from empty, which triggers a new lo_fb_wait_ns
		 * window on each CPU. CPUs would reach here at different times
		 * hopefully avoiding thundering herd.
		 */
		if (cpuc->lo_fb_seq != llcc->lo_fb_seq) {
			cpuc->lo_fb_seq_at = now;
			cpuc->lo_fb_usage_base = cpuc->gstats[GSTAT_LO_FB_USAGE];
			cpuc->lo_fb_seq = llcc->lo_fb_seq;
		}

		/*
		 * lo_fb_share_ppk is applied only after lo_fb_wait_ns has
		 * passed. Always add lo_fb_wait_ns to usage so that the wait
		 * period doesn't contribute to the execution budget.
		 */
		dur = now - cpuc->lo_fb_seq_at;
		usage = cpuc->gstats[GSTAT_LO_FB_USAGE] + lo_fb_wait_ns -
			cpuc->lo_fb_usage_base;

		if (dur > lo_fb_wait_ns && 1024 * usage < lo_fb_share_ppk * dur) {
			if (scx_bpf_dsq_move_to_local(cpuc->lo_fb_dsq_id, 0))
				return;
			tried_lo_fb = true;
		}
	}

	if (cpuc->in_open_layers) {
		/*
		 * CPU is in an open layer.
		 */
		if (cpuc->protect_owned) {
			if (try_consume_layers(cpuc->op_layer_order, nr_op_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
			if (try_consume_layers(cpuc->on_layer_order, nr_on_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
			if (try_consume_layers(cpuc->gp_layer_order, nr_gp_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
			if (try_consume_layers(cpuc->gn_layer_order, nr_gn_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
		} else {
			if (try_consume_layers(cpuc->op_layer_order, nr_op_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
			if (try_consume_layers(cpuc->gp_layer_order, nr_gp_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
			if (try_consume_layers(cpuc->ogn_layer_order, nr_ogn_layers,
					       MAX_LAYERS, cpuc, llcc, false))
				return;
		}
	} else {
		/*
		 * CPU is in a grouped or confined layer or not assigned.
		 */
		struct layer *owner_layer = NULL;

		if (cpuc->layer_id < MAX_LAYERS)
			owner_layer = &layers[cpuc->layer_id];

		/*
		 * Grouped/open preempt layers first if there's no owner layer
		 * or the owner layer is not protected or preempting.
		 */
		if (!owner_layer || (!owner_layer->is_protected && !cpuc->protect_owned && !owner_layer->preempt)) {
			if (try_consume_layers(cpuc->ogp_layer_order, nr_ogp_layers,
					       cpuc->layer_id, cpuc, llcc, false))
				return;

			tried_preempting = true;
		}

		/* owner layer */
		if (owner_layer) {
			if (cpuc->node_id < MAX_NUMA_NODES &&
			    owner_layer->node[cpuc->node_id].llcs_to_drain &&
			    try_drain_layer_node_llcs(owner_layer, cpuc))
				return;
			if (try_consume_layer(owner_layer->id, cpuc, llcc, false))
				return;

			/* CPU is in a protected layer, do not pull from other layers. */
			if (owner_layer->is_protected)
				goto replenish;
		}

		/* try grouped/open preempting if not tried yet */
		if (!tried_preempting &&
		    try_consume_layers(cpuc->ogp_layer_order, nr_ogp_layers,
				       cpuc->layer_id, cpuc, llcc, false))
			return;

		/* grouped/open non-preempt layers */
		if (try_consume_layers(cpuc->ogn_layer_order, nr_ogn_layers,
				       cpuc->layer_id, cpuc, llcc, false))
			return;
	}

replenish:
	if (!tried_lo_fb && scx_bpf_dsq_move_to_local(cpuc->lo_fb_dsq_id, 0))
		return;
        /*
         * !NULL prev_taskc indicates runnable prev.
         * Do not refresh the slice in case we need the task to be reenqueued
         * for layer membership change and subsequent CPU selection.
         */
        if (prev_taskc && prev_layer && !is_task_layer_hint_stale(prev, prev_taskc))
		prev->scx.slice = prev_layer->slice_ns;
}

/*
 * Update per-task duty cycle EWMA. Called from both layered_tick() and
 * layered_stopping() so that kept tasks (which bypass stopping) still
 * get fresh duty_cycle values. last_stopped_at is updated on each call
 * to track the last measurement point.
 */
static void update_duty_cycle(struct cpu_ctx *cpuc, struct task_ctx *taskc,
			      u64 now)
{
	u64 period = now - taskc->last_stopped_at;

	if (period > 0) {
		u64 runnable_start = taskc->runnable_at;
		u64 runnable;
		s32 task_lid = taskc->layer_id;

		if (runnable_start < taskc->last_stopped_at)
			runnable_start = taskc->last_stopped_at;
		runnable = now - runnable_start;

		u64 duty = runnable * (1 << DUTY_CYCLE_SHIFT) / period;
		if (duty > (1 << DUTY_CYCLE_SHIFT))
			duty = (1 << DUTY_CYCLE_SHIFT);
		taskc->duty_cycle =
			((RUNTIME_DECAY_FACTOR - 1) * taskc->duty_cycle + duty) /
			RUNTIME_DECAY_FACTOR;

		/*
		 * Accumulate smoothed runnable time. duty_cycle is an
		 * EWMA of runnable/total, so duty_cycle * period >>
		 * DUTY_CYCLE_SHIFT ~= runnable_ns for this window.
		 * Unlike layer_usages which only counts actual CPU
		 * time, this includes queue wait time - at saturation
		 * the sum exceeds utilization, giving userspace a
		 * signal to rebalance across nodes.
		 */
		if (likely(task_lid < nr_layers))
			cpuc->layer_duty_sum[task_lid] +=
				(taskc->duty_cycle * period) >> DUTY_CYCLE_SHIFT;
	}
	taskc->last_stopped_at = now;
}

void BPF_STRUCT_OPS(layered_tick, struct task_struct *p)
{
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	u64 now = scx_bpf_now();

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(p)))
		return;

	update_duty_cycle(cpuc, taskc, now);
	account_used(p, cpuc, taskc, now);
}

static __noinline bool match_one(struct layer *layer, struct layer_match *match, struct task_ctx *taskc,
				 struct task_struct *p, const char *cgrp_path)
{
	bool result = false;
	const struct cred *cred;

	switch (match->kind) {
	case MATCH_CGROUP_PREFIX: {
		return match_str(match->cgroup_prefix, cgrp_path, STR_PREFIX);
	}
	case MATCH_CGROUP_SUFFIX: {
		return match_str(match->cgroup_suffix, cgrp_path, STR_SUFFIX);
	}
	case MATCH_CGROUP_CONTAINS: {
		return match_str(match->cgroup_substr, cgrp_path, STR_SUBSTR);
	}
	case MATCH_CGROUP_REGEX: {
		u64 cgroup_id = p->cgroups->dfl_cgrp->kn->id;
		u64 *bitmap_ptr;

		bitmap_ptr = bpf_map_lookup_elem(&cgroup_match_bitmap, &cgroup_id);
		if (!bitmap_ptr)
			return false;

		return *bitmap_ptr & (1ULL << match->cgroup_regex_id);
	}
	case MATCH_COMM_PREFIX: {
		char comm[MAX_COMM];
		__builtin_memcpy(comm, p->comm, MAX_COMM);
		return match_str(match->comm_prefix, comm, STR_PREFIX);
	}
	case MATCH_PCOMM_PREFIX: {
		char pcomm[MAX_COMM];

		__builtin_memcpy(pcomm, p->group_leader->comm, MAX_COMM);
		return match_str(match->pcomm_prefix, pcomm, STR_PREFIX);
	}
	case MATCH_NICE_ABOVE:
		return prio_to_nice((s32)p->static_prio) > match->nice;
	case MATCH_NICE_BELOW:
		return prio_to_nice((s32)p->static_prio) < match->nice;
	case MATCH_NICE_EQUALS:
		return prio_to_nice((s32)p->static_prio) == match->nice;
	case MATCH_USER_ID_EQUALS:
		scoped_guard(rcu) {
			cred = p->real_cred;
			if (cred)
				result = cred->euid.val == match->user_id;
		}
		return result;
	case MATCH_GROUP_ID_EQUALS:
		scoped_guard(rcu) {
			cred = p->real_cred;
			if (cred)
				result = cred->egid.val == match->group_id;
		}
		return result;
	case MATCH_PID_EQUALS:
		return p->pid == match->pid;
	case MATCH_PPID_EQUALS:
		return p->real_parent->pid == match->ppid;
	case MATCH_TGID_EQUALS:
		return p->tgid == match->tgid;
	case MATCH_NSPID_EQUALS: {
		// To do namespace pid matching we need to translate the root
		// pid from bpf side to the namespace pid.
		pid_t nspid;
		u64 nsid;
		scoped_guard(rcu) {
			struct pid *p_pid = get_task_pid_ptr(p, PIDTYPE_PID);
			struct pid_namespace *pid_ns = get_task_pid_ns(p, PIDTYPE_TGID);
			if (!p_pid || !pid_ns)
				return result;
			nspid = get_pid_nr_ns(p_pid, pid_ns);
			nsid = BPF_CORE_READ(pid_ns, ns.inum);
		}
		return (u32)nspid == match->pid && nsid == match->nsid;
	}
	case MATCH_NS_EQUALS: {
		u64 nsid;
		scoped_guard(rcu) {
			struct pid *p_pid = get_task_pid_ptr(p, PIDTYPE_PID);
			struct pid_namespace *pid_ns = get_task_pid_ns(p, PIDTYPE_TGID);
			if (!p_pid || !pid_ns)
				return result;
			nsid = BPF_CORE_READ(pid_ns, ns.inum);
		}
		return nsid == match->nsid;
	}
	case MATCH_SCXCMD_JOIN: {
		struct task_ctx *taskc = lookup_task_ctx_may_fail(p);
		if (!taskc) {
			scx_bpf_error("could not find task");
			return false;
		}

		/* The empty string means "no join command". */
		if (!taskc->join_layer[0])
			return false;

		return match_str(match->comm_prefix, taskc->join_layer,
			STR_PREFIX);
	}
	case MATCH_IS_GROUP_LEADER: {
		// There is nuance to this around exec(2)s and group leader swaps.
		// See https://github.com/sched-ext/scx/issues/610 for more details.
		return (p->tgid == p->pid) == match->is_group_leader;
	}
	case MATCH_IS_KTHREAD:
		return p->flags & PF_KTHREAD;

	case MATCH_USED_GPU_TID:
	case MATCH_USED_GPU_PID: {
			u32 key = (match->kind == MATCH_USED_GPU_TID) ? p->pid : p->tgid;
			bool must_be_used = (match->kind == MATCH_USED_GPU_TID) ? match->used_gpu_tid : match->used_gpu_pid;
			u64 now = scx_bpf_now();
			bool recently_used;
			u64 *last_used;

			if (!enable_gpu_support)
				scx_bpf_error("UsedGpuPid requires --enable_gpu_support");

			if (match->kind == MATCH_USED_GPU_TID)
				last_used = bpf_map_lookup_elem(&gpu_tid, &key);
			else
				last_used = bpf_map_lookup_elem(&gpu_tgid, &key);

			/* If not found, we want the used predicate to be required false. */
			if (!last_used || *last_used == MEMBER_INVALID)
				return !must_be_used;

			/*
			 * If the last kprobe fire was more than member_expire_ms ago, timestamp is stale.
			 * Mark us as expired to trigger a rematch if we fire off any GPU kprobes.
			 *
			 * NOTE: member_expire_ms=0 means "never expire", so skip the expiration check.
			 */
			recently_used = true;
			if (layer->member_expire_ms > 0 && taskc &&
				taskc->recheck_layer_membership != MEMBER_NOEXPIRE &&
				taskc->recheck_layer_membership != MEMBER_CANTMATCH &&
				(*last_used) + layer->member_expire_ms * 1000 * 1000 < now) {

				recently_used = false;
				taskc->recheck_layer_membership = MEMBER_EXPIRED;
			}

			return recently_used == must_be_used;
	}
	case MATCH_AVG_RUNTIME: {
			struct task_ctx *taskc = lookup_task_ctx_may_fail(p);
			if (!taskc) {
				scx_bpf_error("could not find task");
				return false;
			}

			u64 avg_runtime_us = taskc->runtime_avg / 1000;

			/* To match, we must get min <= time < max. */
			return match->min_avg_runtime_us <= avg_runtime_us &&
				avg_runtime_us < match->max_avg_runtime_us;
	}
	case MATCH_HINT_EQUALS: {
		struct task_hint *hint = lookup_task_hint(p);

		if (!hint)
			return false;
		return match->hint == hint->hint;
	}
	case MATCH_SYSTEM_CPU_UTIL_BELOW: {
		struct task_hint *hint;
		struct hint_layer_info *info;
		u32 hint_val;

		hint = lookup_task_hint(p);
		if (!hint)
			return false;

		hint_val = hint->hint;
		info = bpf_map_lookup_elem(&hint_to_layer_id_map, &hint_val);
		if (!info)
			return false;

		/* Check if this matcher is enabled for this hint */
		if (info->system_cpu_util_below == (u64)-1)
			return false;

		return system_cpu_util_ewma < info->system_cpu_util_below;
	}
	case MATCH_DSQ_INSERT_BELOW: {
		struct task_hint *hint;
		struct hint_layer_info *info;
		u32 hint_val;

		hint = lookup_task_hint(p);
		if (!hint)
			return false;

		hint_val = hint->hint;
		info = bpf_map_lookup_elem(&hint_to_layer_id_map, &hint_val);
		if (!info)
			return false;

		/* Check if this matcher is enabled for this hint */
		if (info->dsq_insert_below == (u64)-1)
			return false;

		/* Check per-layer DSQ insertion ratio */
		if (layer->id >= MAX_LAYERS)
			return false;

		return layer_dsq_insert_ewma[layer->id] < info->dsq_insert_below;
	}
	case MATCH_NUMA_NODE: {
		struct node_ctx *nodec;
		const struct cpumask *node_cpumask;

		/* Get the NUMA node context */
		if (!(nodec = lookup_node_ctx(match->numa_node_id)))
			return false;

		/* Get the node's CPU mask */
		if (!(node_cpumask = cast_mask(nodec->cpumask)))
			return false;

		/* Check if task's affinity is a subset of the NUMA node's CPUs */
		return bpf_cpumask_subset(p->cpus_ptr, node_cpumask);
	}

	default:
		scx_bpf_error("invalid match kind %d", match->kind);
		return result;
	}
}

__hidden
int match_layer(u32 layer_id, struct task_ctx *taskc,
		struct task_struct *p __arg_trusted, const char *cgrp_path)
{
	bool matched_gpu = false;
	struct layer *layer;
	u32 nr_match_ors, pid;
	u64 or_id, and_id;

	if (layer_id >= nr_layers)
		return -EINVAL;

	layer = &layers[layer_id];
	nr_match_ors = layer->nr_match_ors;

	if (nr_match_ors > MAX_LAYER_MATCH_ORS)
		return -EINVAL;

	bpf_for(or_id, 0, nr_match_ors) {
		struct layer_match_ands *ands;
		bool matched = true;

		barrier_var(or_id);
		if (or_id >= MAX_LAYER_MATCH_ORS)
			return -EINVAL;

		ands = &layer->matches[or_id];

		if (ands->nr_match_ands > NR_LAYER_MATCH_KINDS)
			return -EINVAL;

		matched_gpu = false;
		bpf_for(and_id, 0, ands->nr_match_ands) {
			struct layer_match *match;

			barrier_var(and_id);
			if (and_id >= NR_LAYER_MATCH_KINDS)
				return -EINVAL;

			match = &ands->matches[and_id];
			if (!(match_one(layer, match, taskc, p, cgrp_path) == !match->exclude)) {
				matched = false;
				break;
			}

			if (match->kind == MATCH_USED_GPU_TID || match->kind == MATCH_USED_GPU_PID)
				matched_gpu = true;
		}

		/*
		 * Matched GPU rule but not the rest. That means we'll never match them,
		 * and should mark ourselves as such to avoid being forced to rematch
		 * every time we touch the GPU.
		 */
		if (!matched && matched_gpu) {
			if ((taskc = lookup_task_ctx_may_fail(p)) && taskc) {
				taskc->recheck_layer_membership = MEMBER_CANTMATCH;
			}
		}

		if (matched) {
			trace("MATCH %s-%d -> %s", p->comm, p->pid, layer->name);
			if (enable_match_debug && (pid = p->pid))
				bpf_map_update_elem(&layer_match_dbg, &pid, &layer_id, BPF_ANY);

			return 0;
		}
	}

	return -ENOENT;
}

static void switch_to_layer(struct task_struct *p, struct task_ctx *taskc, u64 layer_id, u64 now)
{
	struct cpu_ctx *cpuc;
	struct llc_ctx *llcc;
	struct layer *layer;

	/* Drop membership from older layer. */
	u32 old_lid = taskc->layer_id;

	if (old_lid < nr_layers) {
		__sync_fetch_and_add(&layers[old_lid].nr_tasks, -1);
		if (taskc->pinned_node < MAX_NUMA_NODES)
			__sync_fetch_and_add(&layers[old_lid].node[taskc->pinned_node].nr_pinned_tasks, -1);
	}

	if (layer_id >= nr_layers)
		return;
	layer = &layers[layer_id];

	if (!(cpuc = lookup_cpu_ctx(scx_bpf_task_cpu(p))) ||
	    !(llcc = lookup_llc_ctx(cpuc->llc_id)))
		return;

	taskc->layer_id = layer_id;
	taskc->llc_id = cpuc->llc_id;
	taskc->layered_cpus.seq = -1;
	taskc->layered_cpus_llc.seq = -1;
	taskc->layered_cpus_node.seq = -1;

	if (taskc->recheck_layer_membership != MEMBER_EXPIRED &&
		taskc->recheck_layer_membership != MEMBER_CANTMATCH) {

		/* Default to MEMBER_NOEXPIRE unless member_expire_ms is set. */
		taskc->recheck_layer_membership = MEMBER_NOEXPIRE;
		if (layer->member_expire_ms)
			taskc->recheck_layer_membership = now + layer->member_expire_ms * 1000 * 1000;
	}
	__sync_fetch_and_add(&layer->nr_tasks, 1);

	refresh_cpus_flags(taskc, p->cpus_ptr);
	if (taskc->pinned_node < MAX_NUMA_NODES)
		__sync_fetch_and_add(&layer->node[taskc->pinned_node].nr_pinned_tasks, 1);

	/*
	 * XXX - To be correct, we'd need to calculate the vtime
	 * delta in the previous layer, scale it by the load
	 * fraction difference and then offset from the new
	 * layer's vtime_now. For now, just do the simple thing
	 * and assume the offset to be zero.
	 *
	 * Revisit if high frequency dynamic layer switching
	 * needs to be supported.
	 */
	p->scx.dsq_vtime = llcc->vtime_now[layer_id];
}

static void maybe_refresh_layer(struct task_struct *p __arg_trusted, struct task_ctx *taskc, u64 now)
{
	const char *cgrp_path;
	bool matched = false;
	u64 layer_id;	// XXX - int makes verifier unhappy

	if (!taskc->refresh_layer)
		return;

	/*
	 * If cgroup regex matching is configured, check if the cgroup bitmap
	 * entry is ready. If not, return without clearing refresh_layer so we
	 * can retry later once userspace populates the map. However, if the
	 * task's layer_id is MAX_LAYERS (initial assignment not done), proceed
	 * anyway as the task can't stay unassigned.
	 */
	bool cgroup_entry_ready = true;

	if (nr_cgroup_regexes > 0) {
		u64 cgroup_id = p->cgroups->dfl_cgrp->kn->id;

		if (!bpf_map_lookup_elem(&cgroup_match_bitmap, &cgroup_id))
			cgroup_entry_ready = false;
	}

	if (!cgroup_entry_ready && taskc->layer_id != MAX_LAYERS)
		return;

	if (cgroup_entry_ready)
		taskc->refresh_layer = false;
	taskc->layer_refresh_seq = layer_refresh_seq_avgruntime;

	if (!(cgrp_path = format_cgrp_path(p->cgroups->dfl_cgrp)))
		return;

	bpf_for(layer_id, 0, nr_layers) {
		if (match_layer(layer_id, taskc, p, cgrp_path) == 0) {
			matched = true;
			break;
		}
	}

	if (matched) {
		switch_to_layer(p, taskc, layer_id, now);
	} else {
		scx_bpf_error("[%s]%d didn't match any layer", p->comm, p->pid);
	}

	if (taskc->layer_id < nr_layers - 1)
		trace("LAYER=%d %s[%d] cgrp=\"%s\"",
		      taskc->layer_id, p->comm, p->pid, cgrp_path);
}

static s32 create_save_cpumask(struct bpf_cpumask **kptr)
{
	struct bpf_cpumask *cpumask;

	cpumask = bpf_cpumask_create();
	if (!cpumask) {
		scx_bpf_error("Failed to create cpumask");
		return -ENOMEM;
	}

	cpumask = bpf_kptr_xchg(kptr, cpumask);
	if (cpumask) {
		scx_bpf_error("kptr already had cpumask");
		bpf_cpumask_release(cpumask);
	}

	return 0;
}

static s32 create_node(u32 node_id)
{
	u32 cpu;
	struct bpf_cpumask *cpumask;
	struct node_ctx *nodec;
	struct cpu_ctx *cpuc;
	s32 ret;

	if (!(nodec = lookup_node_ctx(node_id)))
		return -ENOENT;
	nodec->id = node_id;

	ret = create_save_cpumask(&nodec->cpumask);
	if (ret)
		return ret;
	ret = create_save_cpumask(&nodec->unprotected_cpumask);
	if (ret)
		return ret;

	scoped_guard(rcu) {
		struct bpf_cpumask *unprot;

		cpumask = nodec->cpumask;
		unprot = nodec->unprotected_cpumask;
		if (!cpumask || !unprot) {
			scx_bpf_error("Failed to lookup node cpumask");
			return -ENOENT;
		}

		bpf_for(cpu, 0, nr_possible_cpus) {
			const volatile u64 *nmask;

			nmask = MEMBER_VPTR(numa_cpumasks, [node_id][cpu / 64]);
			if (!nmask) {
				scx_bpf_error("array index error");
				ret = -ENOENT;
				break;
			}

			if (*nmask & (1LLU << (cpu % 64))) {
				bpf_cpumask_set_cpu(cpu, cpumask);
				/* All CPUs start unprotected */
				bpf_cpumask_set_cpu(cpu, unprot);
				if (!(cpuc = lookup_cpu_ctx(cpu))) {
					scx_bpf_error("cpu ctx error");
					ret = -ENOENT;
					break;
				}

				cpuc->node_id = node_id;
				nodec->nr_cpus++;
			}
		}
	}

	dbg("CFG creating node %d with %d cpus", node_id, nodec->nr_cpus);
	return ret;
}

static s32 create_llc(u32 llc_id)
{
	struct bpf_cpumask *cpumask;
	struct llc_ctx *llcc;
	struct cpu_ctx *cpuc;
	struct llc_prox_map *pmap;
	u32 cpu;
	s32 i, ret;

	if (!(llcc = lookup_llc_ctx(llc_id)))
		return -ENOENT;
	llcc->id = llc_id;

	ret = create_save_cpumask(&llcc->cpumask);
	if (ret)
		return ret;

	scoped_guard(rcu) {
		cpumask = llcc->cpumask;
		if (!cpumask) {
			scx_bpf_error("Failed to lookup node cpumask");
			return -ENOENT;
		}

		bpf_for(cpu, 0, nr_possible_cpus) {
			if (!(cpuc = lookup_cpu_ctx(cpu))) {
				scx_bpf_error("cpu ctx error");
				return -ENOENT;
			}

			if (cpu_to_llc_id(cpu) != llc_id)
				continue;

			bpf_cpumask_set_cpu(cpu, cpumask);
			llcc->nr_cpus++;
			cpuc->llc_id = llc_id;
			cpuc->hi_fb_dsq_id = hi_fb_dsq_id(llc_id);
			cpuc->lo_fb_dsq_id = lo_fb_dsq_id(llc_id);
		}
	}

	dbg("CFG creating llc %d with %d cpus", llc_id, llcc->nr_cpus);

	pmap = &llcc->prox_maps[0];
	dbg("CFG: LLC[%d] prox_map node/sys=%d/%d",
	    llc_id, pmap->node_end, pmap->sys_end);
	if (pmap->sys_end > nr_possible_cpus || pmap->sys_end > MAX_CPUS) {
		scx_bpf_error("CPU %d  proximity map too long", cpu);
		return -EINVAL;
	}

	bpf_for(i, 0, pmap->sys_end) {
		u16 *p = MEMBER_VPTR(pmap->llcs, [i]);
		if (p)
			dbg("CFG: LLC[%d] prox[%d]=%d", cpu, i, *p);
	}
	return ret;
}

static __always_inline
void on_wakeup(struct task_struct *p, struct task_ctx *taskc)
{
	struct cpu_ctx *cpuc;
	struct layer *layer;
	struct task_ctx *waker_taskc;
	struct task_struct *waker;

	if (!(cpuc = lookup_cpu_ctx(-1)) ||
	    !(layer = lookup_layer(taskc->layer_id)))
		return;

	if (!(waker = bpf_get_current_task_btf()) ||
	    !(waker_taskc = lookup_task_ctx_may_fail(waker)))
		return;

	// TODO: add handling for per layer wakers
	if (taskc->layer_id == waker_taskc->layer_id)
		return;

	if (taskc->last_waker == waker->pid)
		lstat_inc(LSTAT_XLAYER_REWAKE, layer, cpuc);

	taskc->last_waker = waker->pid;
	lstat_inc(LSTAT_XLAYER_WAKE, layer, cpuc);
}


void BPF_STRUCT_OPS(layered_runnable, struct task_struct *p, u64 enq_flags)
{
	struct task_ctx *taskc;
	u64 now = scx_bpf_now();

	if (!(taskc = lookup_task_ctx(p)))
		return;

	taskc->runnable_at = now;
	maybe_refresh_layer(p, taskc, now);

	if (enq_flags & SCX_ENQ_WAKEUP)
		on_wakeup(p, taskc);
}

void BPF_STRUCT_OPS(layered_running, struct task_struct *p)
{
	struct task_struct *preempting;
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	struct layer *layer;
	struct node_ctx *nodec;
	struct llc_ctx *llcc;
	s32 task_cpu = scx_bpf_task_cpu(p);
	u64 now = scx_bpf_now();
	u32 layer_id;

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(llcc = lookup_llc_ctx(cpuc->llc_id)) ||
	    !(taskc = lookup_task_ctx(p)))
		return;

	layer_id = taskc->layer_id;
	if (!(layer = lookup_layer(layer_id)))
		return;

	task_uncharge_qrt(taskc);

	if (taskc->last_cpu >= 0 && taskc->last_cpu != task_cpu) {
		lstat_inc(LSTAT_MIGRATION, layer, cpuc);
		if (!(nodec = lookup_node_ctx(cpuc->node_id)))
			return;
		if (nodec->cpumask &&
		    !bpf_cpumask_test_cpu(taskc->last_cpu, cast_mask(nodec->cpumask))) {
			struct cpu_ctx *last_cpuc;

			lstat_inc(LSTAT_XNUMA_MIGRATION, layer, cpuc);
			if ((last_cpuc = lookup_cpu_ctx(taskc->last_cpu)))
				xnuma_gate_charge(layer_id,
						  last_cpuc->node_id,
						  cpuc->node_id,
						  taskc->duty_cycle);
		}
		if (llcc->cpumask &&
		    !bpf_cpumask_test_cpu(taskc->last_cpu, cast_mask(llcc->cpumask)))
			lstat_inc(LSTAT_XLLC_MIGRATION, layer, cpuc);
	}
	taskc->last_cpu = task_cpu;

	maybe_update_task_llc(p, taskc, task_cpu);
	if (time_before(llcc->vtime_now[layer_id], p->scx.dsq_vtime))
		llcc->vtime_now[layer_id] = p->scx.dsq_vtime;

	cpuc->current_preempt = layer->preempt ||
		(is_percpu_kthread(p) && is_percpu_kthread_preempting(p));
	cpuc->used_at = now;
	taskc->running_at = now;
	cpuc->is_protected = layer->is_protected;

	preempting = READ_ONCE(cpuc->preempting_task);
	if (preempting) {
		if (preempting == p)
			WRITE_ONCE(cpuc->preempting_task, NULL);
		else if (now - cpuc->preempting_at > CLEAR_PREEMPTING_AFTER) {
			/* this can happen due to e.g. reenqueue_local */
			gstat_inc(GSTAT_PREEMPTING_MISMATCH, cpuc);
			WRITE_ONCE(cpuc->preempting_task, NULL);
		}
	}

	/* running an owned task if the task is on the layer owning the CPU */
	if (layer->kind == LAYER_KIND_OPEN) {
		cpuc->running_owned = cpuc->in_open_layers;
		cpuc->running_open = true;
	} else {
		cpuc->running_owned = taskc->layer_id == cpuc->layer_id;
		cpuc->running_open = false;
	}

	/*
	 * If this CPU is transitioning from running an exclusive task to a
	 * non-exclusive one, the sibling CPU has likely been idle. Wake it up.
	 */
	if (nr_excl_layers) {
		cpuc->next_excl = false;
		cpuc->current_excl = layer->excl;

		if (cpuc->prev_excl && !cpuc->current_excl) {
			s32 sib = sibling_cpu(task_cpu);
			struct cpu_ctx *sib_cpuc;

			if (sib >= 0 && (sib_cpuc = lookup_cpu_ctx(sib))) {
				gstat_inc(GSTAT_EXCL_WAKEUP, cpuc);
				scx_bpf_kick_cpu(sib, SCX_KICK_IDLE);
			}
		}
	}

	if (layer->perf > 0 && cpuc->perf != layer->perf) {
		scx_bpf_cpuperf_set(task_cpu, layer->perf);
		cpuc->perf = layer->perf;
	}
}

void BPF_STRUCT_OPS(layered_stopping, struct task_struct *p, bool runnable)
{
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	struct layer *task_layer;
	u64 now = scx_bpf_now();
	u64 usage_since_idle;
	s32 task_lid;
	u64 runtime;

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(p)))
		return;

	task_lid = taskc->layer_id;
	if (!(task_layer = lookup_layer(task_lid)))
		return;

	runtime = now - taskc->running_at;
	taskc->runtime_avg =
		((RUNTIME_DECAY_FACTOR - 1) * taskc->runtime_avg + runtime) /
		RUNTIME_DECAY_FACTOR;

	update_duty_cycle(cpuc, taskc, now);

	account_used(p, cpuc, taskc, now);

	if (taskc->dsq_id & HI_FB_DSQ_BASE)
		gstat_inc(GSTAT_HI_FB_EVENTS, cpuc);
	else if (taskc->dsq_id & LO_FB_DSQ_BASE)
		gstat_inc(GSTAT_LO_FB_EVENTS, cpuc);

	/*
	 * Owned execution protection. Apply iff the CPU stayed saturated for
	 * longer than twice the slice.
	 */
	usage_since_idle = cpuc->usage - cpuc->usage_at_idle;

	cpuc->protect_owned = false;
	cpuc->protect_owned_preempt = false;
	cpuc->is_protected = false;

	if (cpuc->in_open_layers) {
		if (task_layer->kind == LAYER_KIND_OPEN && !task_layer->preempt) {
			cpuc->protect_owned = usage_since_idle > min_open_layer_disallow_open_after_ns;
			cpuc->protect_owned_preempt = usage_since_idle > min_open_layer_disallow_preempt_after_ns;
		}
	} else {
		struct layer *cpu_layer = NULL;

		if (cpuc->layer_id != MAX_LAYERS &&
		    !(cpu_layer = lookup_layer(cpuc->layer_id)))
			return;

		if (cpu_layer) {
			cpuc->protect_owned = usage_since_idle > cpu_layer->disallow_open_after_ns;
			cpuc->protect_owned_preempt = usage_since_idle > cpu_layer->disallow_preempt_after_ns;
		}
	}

	cpuc->running_fallback = false;
	cpuc->current_preempt = false;

	if (nr_excl_layers) {
		cpuc->prev_excl = cpuc->current_excl;
		cpuc->current_excl = false;
	}

	/*
	 * Apply min_exec_us, scale the execution time by the inverse of the
	 * weight and charge.
	 */
	if (runtime < task_layer->min_exec_ns) {
		lstat_inc(LSTAT_MIN_EXEC, task_layer, cpuc);
		lstat_add(LSTAT_MIN_EXEC_NS, task_layer, cpuc, task_layer->min_exec_ns - runtime);
		runtime = task_layer->min_exec_ns;
	}

	if (cpuc->yielding && runtime < task_layer->slice_ns)
		runtime = task_layer->slice_ns;

	p->scx.dsq_vtime += runtime * 100 / p->scx.weight;
}

bool BPF_STRUCT_OPS(layered_yield, struct task_struct *from, struct task_struct *to)
{
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	struct layer *layer;

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(from)) ||
	    !(layer = lookup_layer(taskc->layer_id)))
		return false;

	/*
	 * Special-case 0 yield_step_ns. Yiedling is completely ignored and
	 * the task is eligible for keep_running().
	 */
	if (!layer->yield_step_ns) {
		lstat_inc(LSTAT_YIELD_IGNORE, layer, cpuc);
		return false;
	}

	if (from->scx.slice > layer->yield_step_ns) {
		from->scx.slice -= layer->yield_step_ns;
		lstat_inc(LSTAT_YIELD_IGNORE, layer, cpuc);
	} else {
		from->scx.slice = 0;
		cpuc->yielding = true;
	}

	return false;
}

void BPF_STRUCT_OPS(layered_set_weight, struct task_struct *p, u32 weight)
{
	struct task_ctx *taskc;

	if ((taskc = lookup_task_ctx(p)))
		taskc->refresh_layer = true;
}

static void refresh_cpus_flags(struct task_ctx *taskc,
			       const struct cpumask *cpumask)
{
	struct layer *layer;
	const struct cpumask *cpuset;
	u32 node_id, nr_intersects = 0, nr_covered = 0, covered_node = MAX_NUMA_NODES;

	if (!all_cpumask) {
		scx_bpf_error("NULL all_cpumask");
		return;
	}

	taskc->all_cpus_allowed =
		bpf_cpumask_subset(cast_mask(all_cpumask), cpumask);

	/*
	 * For cpuset layers, check whether the task's affinity covers the
	 * layer's cpuset. This is safe because cpuset masks are static - they
	 * are configured at init time and never change. Non-cpuset layers have
	 * dynamically changing CPU masks, so this check would go stale.
	 */
	layer = lookup_layer(taskc->layer_id);
	if (!layer)
		return;

	if (layer->has_cpuset) {
		cpuset = (const struct cpumask *)lookup_layer_cpuset(taskc->layer_id);
		if (!cpuset) {
			scx_bpf_error("no cpuset mask found");
			return;
		}
		taskc->all_cpuset_cpus_allowed =
			bpf_cpumask_subset(cpuset, cpumask);
	} else {
		taskc->all_cpuset_cpus_allowed = false;
	}

	/*
	 * Help bpf_for() verification by making the following variables
	 * imprecise. Otherwise, the iterations never converge.
	 */
	__sink(nr_intersects);
	__sink(nr_covered);

	bpf_for(node_id, 0, nr_nodes) {
		struct node_ctx *nodec;
		const struct cpumask *node_cpumask;

		if (!(nodec = lookup_node_ctx(node_id)) ||
		    !(node_cpumask = cast_mask(nodec->cpumask)))
			return;

		if (!bpf_cpumask_intersects(node_cpumask, cpumask))
			continue;

		nr_intersects++;

		if (bpf_cpumask_subset(node_cpumask, cpumask)) {
			nr_covered++;
			covered_node = node_id;
		}
	}

	taskc->cpus_node_aligned = nr_intersects == nr_covered;
	taskc->pinned_node = (nr_nodes > 1 && nr_covered == 1 && nr_intersects == 1) ?
		covered_node : MAX_NUMA_NODES;
}

static int init_cached_cpus(struct cached_cpus *ccpus)
{
	ccpus->id = -1;

	return 0;
}

static int maybe_init_task_unprotected_mask(struct task_struct *p, struct task_ctx *taskc)
{
	struct bpf_cpumask *cpumask;
	int ret;

	/* We don't need our own mask, we have no placement restrictions. */
	if (bpf_cpumask_full(p->cpus_ptr))
		return 0;

	/* Already initialized. */
	if (taskc->layered_unprotected_mask)
		return 0;

	ret = init_cached_cpus(&taskc->layered_cpus_unprotected);
	if (ret)
		return ret;

	if (!(cpumask = bpf_cpumask_create()))
		return -ENOMEM;

	if ((cpumask = bpf_kptr_xchg(&taskc->layered_unprotected_mask, cpumask))) {
		bpf_cpumask_release(cpumask);
		return -EINVAL;
	}

	return 0;
}

void BPF_STRUCT_OPS(layered_set_cpumask, struct task_struct *p,
		    const struct cpumask *cpumask)
{
	struct task_ctx *taskc;

	if (!(taskc = lookup_task_ctx(p)))
		return;

	/*
	 * If the task does not belong to a layer, it has not been
	 * matched to one yet. We need to know which layer the task
	 * belongs to so that we can compute all_cpuset_allowed. Defer
	 * the call until we match.
	 */
	if (taskc->layer_id != MAX_LAYERS) {
		u32 old_pinned = taskc->pinned_node;

		refresh_cpus_flags(taskc, cpumask);

		if (old_pinned != taskc->pinned_node) {
			u32 lid = taskc->layer_id;

			if (lid < nr_layers) {
				if (old_pinned < MAX_NUMA_NODES)
					__sync_fetch_and_add(&layers[lid].node[old_pinned].nr_pinned_tasks, -1);
				if (taskc->pinned_node < MAX_NUMA_NODES)
					__sync_fetch_and_add(&layers[lid].node[taskc->pinned_node].nr_pinned_tasks, 1);
			}
		}
	}

	/* invalidate all cached cpumasks */
	taskc->layered_cpus.seq = -1;
	taskc->layered_cpus_llc.seq = -1;
	taskc->layered_cpus_node.seq = -1;
	taskc->layered_cpus_unprotected.seq = -1;

	maybe_init_task_unprotected_mask(p, taskc);
}

void BPF_STRUCT_OPS(layered_update_idle, s32 cpu, bool idle)
{
	struct cpu_ctx *cpuc;

	if (!idle || !(cpuc = lookup_cpu_ctx(cpu)))
		return;

	cpuc->protect_owned = false;
	cpuc->usage_at_idle = cpuc->usage;
}

void BPF_STRUCT_OPS(layered_cpu_release, s32 cpu,
		    struct scx_cpu_release_args *args)
{
	scx_bpf_reenqueue_local();
}

s32 BPF_STRUCT_OPS(layered_init_task, struct task_struct *p,
		   struct scx_init_task_args *args)
{
	struct task_ctx *taskc;
	struct bpf_cpumask *cpumask;
	s32 ret;

	/*
	 * XXX - We want BPF_NOEXIST but bpf_map_delete_elem() in .disable() may
	 * fail spuriously due to BPF recursion protection triggering
	 * unnecessarily.
	 */
	taskc = bpf_task_storage_get(&task_ctxs, p, 0,
				    BPF_LOCAL_STORAGE_GET_F_CREATE);
	if (!taskc) {
		scx_bpf_error("task_ctx allocation failure");
		return -ENOMEM;
	}

	if (membw_event) {
		ret = scx_pmu_task_init(p);
		if (ret)
			return ret;
	}

	// Layer setup
	ret = init_cached_cpus(&taskc->layered_cpus);
	if (ret)
		return ret;
	if (!(cpumask = bpf_cpumask_create()))
		return -ENOMEM;

	if ((cpumask = bpf_kptr_xchg(&taskc->layered_mask, cpumask))) {
		/* Should never happen as we just inserted it above. */
		bpf_cpumask_release(cpumask);
		return -EINVAL;
	}

	// LLC setup
	ret = init_cached_cpus(&taskc->layered_cpus_llc);
	if (ret)
		return ret;

	if (!(cpumask = bpf_cpumask_create()))
		return -ENOMEM;

	if ((cpumask = bpf_kptr_xchg(&taskc->layered_llc_mask, cpumask))) {
		bpf_cpumask_release(cpumask);
		return -EINVAL;
	}

	// Node setup
	ret = init_cached_cpus(&taskc->layered_cpus_node);
	if (ret)
		return ret;

	if (!(cpumask = bpf_cpumask_create()))
		return -ENOMEM;

	if ((cpumask = bpf_kptr_xchg(&taskc->layered_node_mask, cpumask))) {
		bpf_cpumask_release(cpumask);
		return -EINVAL;
	}

	// Unprotected CPU idle mask setup if necessary
	ret = maybe_init_task_unprotected_mask(p, taskc);
	if (ret)
		return ret;

	taskc->pid = p->pid;
	taskc->last_cpu = -1;
	taskc->layer_id = MAX_LAYERS;
	taskc->refresh_layer = true;
	taskc->llc_id = MAX_LLCS;
	taskc->pinned_node = MAX_NUMA_NODES;
	taskc->qrt_layer_id = MAX_LAYERS;
	taskc->qrt_llc_id = MAX_LLCS;

	/*
	 * Necessary for GPU membership logic. The field is overwritten during
	 * .running() and read during .stopping(), so this value is only visible
	 * from the GPU membership kprobes.
	 */
	taskc->running_at = MEMBER_INVALID;

	/*
	 * Start runtime_avg at some arbitrary sane-ish value. If this becomes a
	 * problem, we can track per-parent avg new task initial runtime avg and
	 * used that instead.
	 */
	taskc->runtime_avg = slice_ns / 4;
	/* Start at 25% — EWMA converges quickly */
	taskc->duty_cycle = (1 << DUTY_CYCLE_SHIFT) / 4;
	taskc->last_stopped_at = scx_bpf_now();

	/*
	 * We are matching cgroup hierarchy path directly rather than the CPU
	 * controller path. As the former isn't available during the scheduler
	 * fork path, let's delay the layer selection until the first
	 * runnable().
	 */

	return 0;
}

void BPF_STRUCT_OPS(layered_exit_task, struct task_struct *p,
		    struct scx_exit_task_args *args)
{
	struct cpu_ctx *cpuc;
	struct task_ctx *taskc;
	u32 pid;

	if (args->cancelled) {
		return;
	}

	if (enable_match_debug && (pid = p->pid))
		bpf_map_delete_elem(&layer_match_dbg, &pid);

	if (!(cpuc = lookup_cpu_ctx(-1)) || !(taskc = lookup_task_ctx(p)))
		return;

	u32 lid = taskc->layer_id;

	if (lid < nr_layers) {
		__sync_fetch_and_add(&layers[lid].nr_tasks, -1);
		if (taskc->pinned_node < MAX_NUMA_NODES)
			__sync_fetch_and_add(&layers[lid].node[taskc->pinned_node].nr_pinned_tasks, -1);
	}

	if (membw_event)
		scx_pmu_task_fini(p);
}

void BPF_STRUCT_OPS(layered_disable, struct task_struct *p)
{
	struct task_ctx *taskc;

	if (!(taskc = lookup_task_ctx(p)))
		return;

	/*
	 * XXX: Ideally, this should be in ops.dequeue(). See
	 * layered_enqueue().
	 */
	task_uncharge_qrt(taskc);
}

static s64 dsq_first_runnable_at_ms(u64 dsq_id, u64 now)
{
	struct task_struct *p;

	bpf_for_each(scx_dsq, p, dsq_id, 0) {
		struct task_ctx *taskc;

		if ((taskc = lookup_task_ctx(p))) {
			u64 runnable_at = taskc->runnable_at;

			if (runnable_at >= now)
				return ((taskc->runnable_at - now) / 1000000);
			else
				return -((now - taskc->runnable_at) / 1000000);
		}
	}

	return 0;
}

__hidden void dump_cpumask_word(s32 word, struct cpumask *cpumask)
{
	u32 u, v = 0;

	bpf_for(u, 0, 32) {
		s32 cpu = 32 * word + u;
		if (cpu < nr_cpu_ids &&
		    bpf_cpumask_test_cpu(cpu, cpumask))
			v |= 1 << u;
	}
	scx_bpf_dump("%08x", v);
}

int dump_layer_cpumask(int id)
{
	struct cpumask *layer_cpumask;
	u32 word, nr_words = (nr_cpu_ids + 31) / 32;

	if (!(layer_cpumask = lookup_layer_cpumask(id)))
		return -ENOENT;

	bpf_for(word, 0, nr_words) {
		if (word)
			scx_bpf_dump(",");
		dump_cpumask_word(nr_words - word - 1, layer_cpumask);
	}

	return 0;
}

void BPF_STRUCT_OPS(layered_dump, struct scx_dump_ctx *dctx)
{
	u64 now = scx_bpf_now();
	u64 dsq_id;
	int i, j;
	struct layer *layer;

	scx_bpf_dump_header();

	if (nr_layers > MAX_LAYERS) {
		scx_bpf_error("Invalid number of layers %d", nr_layers);
		return;
	}

	bpf_for(i, 0, nr_layers) {
		layer = lookup_layer(i);
		if (!layer) {
			scx_bpf_error("unable to lookup layer %d", i);
			return;
		}

		bpf_for(j, 0, nr_llcs) {
			dsq_id = layer_dsq_id(layer->id, j);
			scx_bpf_dump("LAYER[%d](%s)-DSQ[%llx] nr_cpus=%u nr_queued=%d %+lldms\n",
				     i, layer->name, dsq_id, layer->nr_cpus,
				     scx_bpf_dsq_nr_queued(dsq_id),
				     dsq_first_runnable_at_ms(dsq_id, now));
		}
		scx_bpf_dump("LAYER[%d](%s) CPUS=", i, layer->name);
		dump_layer_cpumask(i);
		scx_bpf_dump("\n");
	}
	bpf_for(i, 0, nr_llcs) {
		dsq_id = hi_fb_dsq_id(i);
		scx_bpf_dump("HI_[%llx] nr_queued=%d %+lldms\n",
			     dsq_id, scx_bpf_dsq_nr_queued(dsq_id),
			     dsq_first_runnable_at_ms(dsq_id, now));
		dsq_id = lo_fb_dsq_id(i);
		scx_bpf_dump("LO_FALLBACK[%llx] nr_queued=%d %+lldms\n",
			     dsq_id, scx_bpf_dsq_nr_queued(dsq_id),
			     dsq_first_runnable_at_ms(dsq_id, now));
	}
}


/*
 * When a timer is defined it is first scheduled run after the interval_ns. The
 * timer callback must return a non zero value to reschedule the timer. The
 * return value is in nanoseconds.
 */
struct layered_timer layered_timers[MAX_TIMERS] = {
	{15LLU * NSEC_PER_SEC, CLOCK_BOOTTIME, 0},
};

/**
 * antistall_set() - set antistall flags.
 * @dsq_id: Dsq to check for delayed tasks.
 * @jiffies_now: Time to check against in jiffies.
 *
 * This function sets entries in antistall_cpu_dsq used by antistall.
 * It checks the given DSQ to see if delay exceeds antistall_sec.
 * It tries to find a CPU satisfying the constraints of "can run the first
 * task in the provided DSQ" and "is not already flagged for use in antistall".
 * If it cannot find such a CPU to flag, it will try to flag a CPU flagged to
 * process another with a lesser delay if one exists.
 */
u64 antistall_set(u64 dsq_id, u64 jiffies_now)
{
	struct task_struct *__p;
	struct task_ctx *taskc;
	s32 cpu;
	u64 *antistall_dsq, *delay, cur_delay;
	int pass;

	if (!dsq_id || !jiffies_now)
		return 0;

	guard(rcu)();
	bpf_for_each(scx_dsq, __p, dsq_id, 0) {
		struct task_struct *p __free(task) = bpf_task_from_pid(__p->pid);
		if (!p)
			continue;

		if (!(taskc = lookup_task_ctx(p)))
			return 0;

		cur_delay = get_delay_sec(p, jiffies_now);
		if (cur_delay <= antistall_sec)
			// check head task in dsq
			return 0;

		#pragma unroll
		for (pass = 0; pass < 2; ++pass) bpf_for(cpu, 0, nr_possible_cpus) {
			const struct cpumask *cpumask;

			if (!(cpumask = cast_mask(taskc->layered_mask)))
				return 0;

			/* for affinity violating tasks, target all allowed CPUs */
			if (bpf_cpumask_empty(cpumask))
				cpumask = p->cpus_ptr;

			if (!bpf_cpumask_test_cpu(cpu, cpumask))
				continue;

			antistall_dsq = bpf_map_lookup_percpu_elem(&antistall_cpu_dsq, &zero_u32, cpu);
			delay = bpf_map_lookup_percpu_elem(&antistall_cpu_max_delay, &zero_u32, cpu);

			if (!antistall_dsq || !delay) {
				scx_bpf_error("can't happen");
				return 0;
			}

			if ((pass == 0 && *antistall_dsq == SCX_DSQ_INVALID) ||
			    (pass != 0 && *delay < cur_delay)) {
				trace("antistall set DSQ[%llu] SELECTED_CPU[%llu] DELAY[%llu]", dsq_id, cpu, cur_delay);
				*delay = cur_delay;
				*antistall_dsq = dsq_id;
				return 0;
			}
		}

		return 0;
	}

	return 0;
}

/**
 * antistall_scan() - call antistall_set on all DSQs.
 *
 * This function calls antistall_set on all DSQs.
 * This is where antistall figures out what work, if any, needs
 * to be prioritized to keep runnable_at delay at or below antistall_sec.
 */
static u64 antistall_scan(void)
{
	s32 llc;
	u64 layer_id;
	u64 jiffies_now;

	if (!enable_antistall)
		return 0;

	jiffies_now = bpf_jiffies64();

	bpf_for(layer_id, 0, nr_layers)
		bpf_for(llc, 0, nr_llcs)
			antistall_set(layer_dsq_id(layer_id, llc), jiffies_now);

	bpf_for(llc, 0, nr_llcs) {
		antistall_set(hi_fb_dsq_id(llc), jiffies_now);
		antistall_set(lo_fb_dsq_id(llc), jiffies_now);
	}

	return layered_timers[ANTISTALL_TIMER].interval_ns;
}

/*
 * Timer callback that runs all registered timers. If a timer returns a non
 * zero value it is rerun after the return value (in nanoseconds).
 */
u64 run_timer_cb(int key)
{
	switch (key) {
	case ANTISTALL_TIMER:
		return antistall_scan();
	case MAX_TIMERS:
	default:
		return 0;
	}
}

__weak int
init_layer_cpumasks(int layer_id)
{
	struct bpf_cpumask *cpumask, *cpuset;
	struct layer_cpumask_wrapper *cpumaskw;

	if (!(cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id)))
		return -ENOENT;

	cpuset = bpf_cpumask_create();
	if (!cpuset)
		return -ENOMEM;

	cpuset = bpf_kptr_xchg(&cpumaskw->cpuset, cpuset);
	if (cpuset)
		bpf_cpumask_release(cpuset);

	cpumask = bpf_cpumask_create();
	if (!cpumask)
		return -ENOMEM;

	cpumask = bpf_kptr_xchg(&cpumaskw->cpumask, cpumask);
	if (cpumask)
		bpf_cpumask_release(cpumask);

	struct bpf_cpumask *node_cpumask;
	u32 nid;

	bpf_for(nid, 0, nr_nodes) {
		struct layer_node_cpumask_wrapper *node_cpumaskw;
		u32 key = layer_id * MAX_NUMA_NODES + nid;

		if (!(node_cpumaskw = bpf_map_lookup_elem(&layer_node_cpumasks, &key)))
			return -ENOENT;
		node_cpumask = bpf_cpumask_create();
		if (!node_cpumask)
			return -ENOMEM;
		node_cpumask = bpf_kptr_xchg(&node_cpumaskw->cpumask, node_cpumask);
		if (node_cpumask)
			bpf_cpumask_release(node_cpumask);
	}

	layer_cpuset_bpfmask(layer_id);

	scoped_guard(rcu) {
		/* Look the masks back up to make the verifier happy. */
		if (!(cpumaskw = bpf_map_lookup_elem(&layer_cpumasks, &layer_id)) ||
		    !(cpumask = cpumaskw->cpumask) ||
		    !(cpuset = cpumaskw->cpuset))
			return -EINVAL;

		/*
		 * Start all layers with their full cpuset so that everything runs
		 * everywhere. This will soon be updated by refresh_cpumasks()
		 * once the scheduler starts running.
		 */
		bpf_cpumask_copy(cpumask, (const struct cpumask *)cpuset);
	}

	return 0;
}

/*
 * Initializes per-layer specific data structures.
 */
static s32 init_layer(int layer_id)
{
	struct layer *layer = &layers[layer_id];
	int i, j, ret;

	dbg("CFG LAYER[%d][%s] min_exec_ns=%lu open=%d preempt=%d excl=%d",
	    layer_id, layer->name, layer->min_exec_ns,
	    layer->kind != LAYER_KIND_CONFINED,
	    layer->preempt, layer->excl);
	dbg("CFG      disallow_open/preempt_after/protected=%lu/%lu/%d",
	    layer->disallow_open_after_ns, layer->disallow_preempt_after_ns,
	    layer->is_protected);

	layer->id = layer_id;

	if (layer->nr_match_ors > MAX_LAYER_MATCH_ORS) {
		scx_bpf_error("too many ORs");
		return -EINVAL;
	}

	bpf_for(i, 0, layer->nr_match_ors) {
		struct layer_match_ands *ands = MEMBER_VPTR(layers, [layer_id].matches[i]);
		if (!ands) {
			scx_bpf_error("shouldn't happen");
			return -EINVAL;
		}

		if (ands->nr_match_ands > NR_LAYER_MATCH_KINDS) {
			scx_bpf_error("too many ANDs");
			return -EINVAL;
		}

		dbg("CFG   OR[%02d]", i);

		bpf_for(j, 0, ands->nr_match_ands) {
			char header[32];
			u64 header_data[1] = { j };
			struct layer_match *match;

			bpf_snprintf(header, sizeof(header), "CFG     AND[%02d]:",
				     header_data, sizeof(header_data));

			match = MEMBER_VPTR(layers, [layer_id].matches[i].matches[j]);
			if (!match) {
				scx_bpf_error("shouldn't happen");
				return -EINVAL;
			}

			switch (match->kind) {
			case MATCH_CGROUP_PREFIX:
				dbg("%s CGROUP_PREFIX \"%s\"", header, match->cgroup_prefix);
				break;
			case MATCH_COMM_PREFIX:
				dbg("%s COMM_PREFIX \"%s\"", header, match->comm_prefix);
				break;
			case MATCH_PCOMM_PREFIX:
				dbg("%s PCOMM_PREFIX \"%s\"", header, match->pcomm_prefix);
				break;
			case MATCH_NICE_ABOVE:
				dbg("%s NICE_ABOVE %d", header, match->nice);
				break;
			case MATCH_NICE_BELOW:
				dbg("%s NICE_BELOW %d", header, match->nice);
				break;
			case MATCH_NICE_EQUALS:
				dbg("%s NICE_EQUALS %d", header, match->nice);
				break;
			case MATCH_USER_ID_EQUALS:
				dbg("%s USER_ID %u", header, match->user_id);
				break;
			case MATCH_GROUP_ID_EQUALS:
				dbg("%s GROUP_ID %u", header, match->group_id);
				break;
			case MATCH_PID_EQUALS:
				dbg("%s PID %u", header, match->pid);
				break;
			case MATCH_PPID_EQUALS:
				dbg("%s PPID %u", header, match->ppid);
				break;
			case MATCH_TGID_EQUALS:
				dbg("%s TGID %u", header, match->tgid);
				break;
			case MATCH_NSPID_EQUALS:
				dbg("%s NSID %lld PID %d",
				    header, match->nsid, match->pid);
				break;
			case MATCH_NS_EQUALS:
				dbg("%s NSID %lld", header, match->nsid);
				break;
			case MATCH_SCXCMD_JOIN:
				dbg("%s SCXCMD_JOIN \"%s\"", header, match->comm_prefix);
				break;
			case MATCH_IS_GROUP_LEADER:
				dbg("%s IS_GROUP_LEADER %d", header, match->is_group_leader);
				break;
			case MATCH_IS_KTHREAD:
				dbg("%s IS_KTHREAD %d", header, match->is_kthread);
				break;
			case MATCH_USED_GPU_TID:
				dbg("%s GPU_TID %d", header, match->used_gpu_tid);
				break;
			case MATCH_USED_GPU_PID:
				dbg("%s GPU_PID %d", header, match->used_gpu_pid);
				break;
			case MATCH_AVG_RUNTIME:
				layer->periodically_refresh = true;
				dbg("%s AVG_RUNTIME [%lluus, %lluus)", header,
					match->min_avg_runtime_us,
					match->max_avg_runtime_us);
			case MATCH_CGROUP_SUFFIX:
				dbg("%s CGROUP_SUFFIX \"%s\"", header, match->cgroup_suffix);
				break;
			case MATCH_CGROUP_CONTAINS:
				dbg("%s CGROUP_CONTAINS \"%s\"", header, match->cgroup_substr);
				break;
			case MATCH_CGROUP_REGEX:
				dbg("%s CGROUP_REGEX %d", header, match->cgroup_regex_id);
				break;
			case MATCH_HINT_EQUALS:
				dbg("%s HINT_EQUALS %d", header, match->hint);
				break;
			case MATCH_SYSTEM_CPU_UTIL_BELOW:
				dbg("%s SYSTEM_CPU_UTIL_BELOW %llu", header, match->system_cpu_util_below);
				break;
			case MATCH_DSQ_INSERT_BELOW:
				dbg("%s DSQ_INSERT_BELOW %llu", header, match->dsq_insert_below);
				break;
			case MATCH_NUMA_NODE:
				dbg("%s MATCH_NUMA_NODE %llu", header, match->numa_node_id);
				break;
			default:
				scx_bpf_error("%s Invalid kind", header);
				return -EINVAL;
			}
		}
		if (ands->nr_match_ands == 0)
			dbg("CFG     DEFAULT");
	}

	if ((ret = init_layer_cpumasks(layer_id))) {
		scx_bpf_error("could not initialize cpumasks");
		return ret;
	}

	// create the dsqs for the layer
	bpf_for(i, 0, nr_llcs) {
		u64 dsq_id = layer_dsq_id(layer_id, i);
		int node_id = llc_node_id(i);

		dbg("CFG creating DSQ 0x%llx for layer %d %s on LLC %d (node %d)",
		    dsq_id, layer_id, layer->name, i, node_id);
		ret = scx_bpf_create_dsq(dsq_id, node_id);
		if (ret < 0)
			return ret;
	}

	return 0;
}

/*
 * Initializes per CPU data structures.
 */
static s32 init_cpu(s32 cpu, int *nr_online_cpus,
		    struct bpf_cpumask *cpumask,
		    struct bpf_cpumask *tmp_big_cpumask,
		    struct bpf_cpumask *tmp_unprotected_cpumask)
{
	const volatile u8 *u8_ptr;
	struct cpu_ctx *cpuc;
	struct cpu_prox_map *pmap;
	u64 *init_antistall_dsq;
	int i;

	init_antistall_dsq = bpf_map_lookup_percpu_elem(&antistall_cpu_dsq,
							&zero_u32, cpu);
	if (init_antistall_dsq) {
		*init_antistall_dsq = SCX_DSQ_INVALID;
	}

	if (!(cpuc = lookup_cpu_ctx(cpu))) {
		return -ENOMEM;
	}


	/*
	 * By default, set all CPUs as unprotected, we'll converge eventually in
	 * refresh_layer_cpuc.
	 */
	bpf_cpumask_set_cpu(cpu, tmp_unprotected_cpumask);

	if ((u8_ptr = MEMBER_VPTR(all_cpus, [cpu / 8]))) {
		if (*u8_ptr & (1 << (cpu % 8))) {
			bpf_cpumask_set_cpu(cpu, cpumask);
			(*nr_online_cpus)++;
			if (cpuc->is_big)
				bpf_cpumask_set_cpu(cpu, tmp_big_cpumask);
		}
	} else {
		return -EINVAL;
	}

	pmap = &cpuc->prox_map;
	dbg("CFG: CPU[%d] prox_map core/llc/node/sys=%d/%d/%d/%d",
	    cpu, pmap->core_end, pmap->llc_end, pmap->node_end, pmap->sys_end);
	if (pmap->sys_end > nr_possible_cpus || pmap->sys_end > MAX_CPUS) {
		scx_bpf_error("CPU %d  proximity map too long", cpu);
		return -EINVAL;
	}

	// too much output, overruns trace buf, maybe come up with a way to compact
	if (cpu == 0) {
		bpf_for(i, 0, pmap->sys_end) {
			u16 *p = MEMBER_VPTR(pmap->cpus, [i]);
			if (p)
				dbg("CFG: CPU[%d] prox[%d]=%d", cpu, i, *p);
		}
	}

	bpf_for(i, 0, nr_op_layers + nr_gp_layers)
		dbg("CFG: CPU[%d] ogp_layer_order[%d]=%d",
		    cpu, i, cpuc->ogp_layer_order[i]);
	bpf_for(i, 0, nr_on_layers + nr_gn_layers)
		dbg("CFG: CPU[%d] ogn_layer_order[%d]=%d",
		    cpu, i, cpuc->ogn_layer_order[i]);

	bpf_for(i, 0, nr_op_layers)
		dbg("CFG: CPU[%d] op_layer_order[%d]=%d",
		    cpu, i, cpuc->op_layer_order[i]);
	bpf_for(i, 0, nr_on_layers)
		dbg("CFG: CPU[%d] on_layer_order[%d]=%d",
		    cpu, i, cpuc->on_layer_order[i]);
	bpf_for(i, 0, nr_gp_layers)
		dbg("CFG: CPU[%d] gp_layer_order[%d]=%d",
		    cpu, i, cpuc->gp_layer_order[i]);
	bpf_for(i, 0, nr_gn_layers)
		dbg("CFG: CPU[%d] gn_layer_order[%d]=%d",
		    cpu, i, cpuc->gn_layer_order[i]);

	return 0;
}

s32 BPF_STRUCT_OPS_SLEEPABLE(layered_init)
{
	int i, nr_online_cpus, ret;

	struct bpf_cpumask *cpumask __free(bpf_cpumask) = bpf_cpumask_create();
	if (!cpumask)
		return -ENOMEM;

	struct bpf_cpumask *tmp_big_cpumask __free(bpf_cpumask) = bpf_cpumask_create();
	if (!tmp_big_cpumask)
		return -ENOMEM;

	struct bpf_cpumask *tmp_unprotected_cpumask __free(bpf_cpumask) = bpf_cpumask_create();
	if (!tmp_unprotected_cpumask)
		return -ENOMEM;

	nr_online_cpus = 0;
	bpf_for(i, 0, nr_possible_cpus) {
		ret = init_cpu(i, &nr_online_cpus, cpumask, tmp_big_cpumask, tmp_unprotected_cpumask);
		if (ret != 0)
			return ret;
	}

	struct bpf_cpumask *old;

	old = bpf_kptr_xchg(&all_cpumask, no_free_ptr(cpumask));
	if (old)
		bpf_cpumask_release(old);

	old = bpf_kptr_xchg(&big_cpumask, no_free_ptr(tmp_big_cpumask));
	if (old)
		bpf_cpumask_release(old);

	old = bpf_kptr_xchg(&unprotected_cpumask, no_free_ptr(tmp_unprotected_cpumask));
	if (old)
		bpf_cpumask_release(old);

	bpf_for(i, 0, nr_nodes) {
		ret = create_node(i);
		if (ret)
			return ret;
	}
	bpf_for(i, 0, nr_llcs) {
		ret = create_llc(i);
		if (ret)
			return ret;
	}

	dbg("CFG: Dumping configuration, nr_online_cpus=%d smt_enabled=%d little_cores=%d",
	    nr_online_cpus, smt_enabled, has_little_cores);
	dbg("CFG: min_open_layer_disallow_open/preempt_after=%lu/%lu",
	    min_open_layer_disallow_open_after_ns, min_open_layer_disallow_preempt_after_ns);

	bpf_for(i, 0, nr_layers) {
		ret = init_layer(i);
		if (ret != 0)
			return ret;
	}

	bpf_for(i, 0, nr_llcs) {
		u64 dsq_id;

		dsq_id = hi_fb_dsq_id(i);
		dbg("CFG creating hi fallback DSQ 0x%llx on LLC %d", dsq_id, i);
		ret = scx_bpf_create_dsq(dsq_id, llc_node_id(i));
		if (ret < 0)
			return ret;

		dsq_id = lo_fb_dsq_id(i);
		dbg("CFG creating lo fallback DSQ 0x%llx on LLC %d", dsq_id, i);
		ret = scx_bpf_create_dsq(dsq_id, llc_node_id(i));
		if (ret < 0)
			return ret;
	}

	ret = start_layered_timers();
	if (ret < 0)
		return ret;

	if (membw_event) {
		ret = scx_pmu_install(membw_event);
		if (ret)
			return ret;
	}

	return 0;
}

void BPF_STRUCT_OPS(layered_exit, struct scx_exit_info *ei)
{
	if (membw_event)
		scx_pmu_uninstall(membw_event);

	UEI_RECORD(uei, ei);
}

SCX_OPS_DEFINE(layered,
	       .select_cpu		= (void *)layered_select_cpu,
	       .enqueue			= (void *)layered_enqueue,
	       .dispatch		= (void *)layered_dispatch,
	       .tick			= (void *)layered_tick,
	       .runnable		= (void *)layered_runnable,
	       .running			= (void *)layered_running,
	       .stopping		= (void *)layered_stopping,
	       .yield			= (void *)layered_yield,
	       .set_weight		= (void *)layered_set_weight,
	       .set_cpumask		= (void *)layered_set_cpumask,
	       .update_idle		= (void *)layered_update_idle,
	       .cpu_release		= (void *)layered_cpu_release,
	       .init_task		= (void *)layered_init_task,
	       .exit_task		= (void *)layered_exit_task,
	       .disable			= (void *)layered_disable,
	       .dump			= (void *)layered_dump,
	       .init			= (void *)layered_init,
	       .exit			= (void *)layered_exit,
	       .flags			= SCX_OPS_KEEP_BUILTIN_IDLE |
					  SCX_OPS_ENQ_LAST,
	       .name			= "layered");
