scx_bpf_error_bstr(9)
π scx_bpf_error_bstr(9) β from the Kernel API Manual, bestie
okay so real talk, this one is from the Kernel API Manual and it's a little dramatic β it's literally the "we're cooked, sound the alarm" function for the BPF scheduler. like, main character energy but in a bad way π
β¨ NAME β¨
scx_bpf_error_bstr β the "indicate fatal error" girlie. that's it, that's her whole job π
π¦ SYNOPSIS π¦
__bpf_kfunc void scx_bpf_error_bstr (char *fmt , unsigned long long
data , u32 data__sz , const struct bpf_prog_aux *aux );
π ARGUMENTS π
fmtβ the error message format string, aka the lil blurb that explains what went wrong π«Άdataβ the format string parameters, packaged up using the___bpf_fillmacro. yes, packaged. like a cute little gift basket of args πdata__szβ the data len, and ngl it must end in__szfor the verifier. no cap, this is a naming rule, not a suggestion πauxβ the implicit BPF argument that gives you access tobpf_prog_aux, hidden from BPF progs π (it's shy)
π₯ DESCRIPTION π₯
okay so here's the vibe check: you call this when your BPF scheduler runs into a fatal error. it says "yep, we're done here" and kicks off ops disabling. like the function unalives the operation. dramatic? yes. necessary? also yes π
it's a fatal error indicator, bestie β not a gentle warning, not a "hey maybe reconsider". fatal. periodt π
π SEE ALSO π
the whole extended fam, all hanging out in the kernel file ./kernel/sched/ext/ext.c β go say hi π
scx_is_descendant(9)rq_is_open(9)scx_fill_cmask_scratch(9)scx_call_op_set_cpumask(9)nldsq_next_task(9)nldsq_cursor_next_task(9)nldsq_cursor_lost_task(9)scx_task_iter_start(9)scx_task_iter_unlock(9)scx_task_iter_relock(9)scx_task_iter_stop(9)scx_task_iter_next(9)scx_task_iter_next_locked(9)scx_dump_event(9)wait_ops_state(9)scx_cpu_valid(9)schedule_deferred(9)schedule_deferred_locked(9)dsq_insert_head(9)set_task_slice_keep_oob(9)scx_task_slice_ended(9)move_remote_task_to_local_dsq(9)unlink_dsq_and_switch_rq_lock(9)move_task_between_dsqs(9)dispatch_to_local_dsq(9)finish_dispatch(9)scx_prio_less(9)__scx_init_task(9)task_dead_and_done(9)scx_tg_sched(9)scx_tg_knob_sched(9)handle_lockup(9)scx_rcu_cpu_stall(9)scx_softlockup(9)scx_hardlockup(9)unbypass_renotify_idle(9)scx_bypass(9)scx_propagate_exit_irq_workfn(9)scx_flush_disable_work(9)print_scx_info(9)scx_bpf_dsq_insert___v2(9)__scx_bpf_dsq_insert_vtime(9)scx_bpf_dispatch_nr_slots(9)scx_bpf_dispatch_cancel(9)scx_bpf_dsq_move_to_local___v2(9)scx_bpf_dsq_move_set_slice(9)scx_bpf_dsq_move_set_vtime(9)scx_bpf_dsq_move(9)scx_bpf_dsq_move_vtime(9)scx_bpf_reenqueue_local(9)scx_bpf_create_dsq(9)scx_bpf_task_set_slice(9)scx_bpf_task_set_dsq_vtime(9)scx_bpf_kick_cpu(9)scx_bpf_kick_cid(9)scx_bpf_dsq_nr_queued(9)scx_bpf_destroy_dsq(9)bpf_iter_scx_dsq_new(9)bpf_iter_scx_dsq_next(9)bpf_iter_scx_dsq_destroy(9)scx_bpf_dsq_peek(9)scx_bpf_dsq_reenq(9)scx_bpf_reenqueue_local___v2(9)scx_bpf_exit_bstr(9)scx_bpf_dump_bstr(9)scx_bpf_cpuperf_cap(9)scx_bpf_cidperf_cap(9)scx_bpf_cpuperf_cur(9)scx_bpf_cidperf_cur(9)scx_bpf_cpuperf_set(9)scx_bpf_cidperf_set(9)scx_bpf_nr_node_ids(9)scx_bpf_nr_cpu_ids(9)scx_bpf_nr_cids(9)scx_bpf_nr_online_cids(9)scx_bpf_online_cmask(9)scx_bpf_this_cid(9)scx_bpf_get_possible_cpumask(9)scx_bpf_get_online_cpumask(9)scx_bpf_put_cpumask(9)scx_bpf_task_running(9)scx_bpf_task_cpu(9)scx_bpf_task_cid(9)scx_bpf_locked_rq(9)scx_bpf_cpu_curr(9)scx_bpf_cid_curr(9)scx_bpf_tid_to_task(9)scx_bpf_now(9)scx_bpf_events(9)scx_bpf_task_cgroup(9)
okay that's the whole page, you ate that π«Ά go forth and handle your fatal errors with grace β¨
this lil masterpiece lives in ./kernel/sched/ext and it's dated October 2026 β signed, sealed, delivered, slay π
π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms