ti_sci_cmd_proc_get_status(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

🌸 ti_sci_cmd_proc_get_status 🌸

okay bestie, this is a page from the Kernel API Manual and it's about one very specific little function: ti_sci_cmd_proc_get_status. yes that's a mouthful, we're gonna get through it together πŸ’–


✨ NAME ✨

ti_sci_cmd_proc_get_status β€” Command to get the processor boot status πŸ‘‘

✨ SYNOPSIS ✨

int ti_sci_cmd_proc_get_status (const struct ti_sci_handle *handle , u8
proc_id , u64 *bv , u32 *cfg_flags , u32 *ctrl_flags , u32 *sts_flags );

it's giving "six parameters, zero chill" but honestly it's not scary, come on 🫢

✨ ARGUMENTS ✨

  • handle β€” Pointer to TI SCI handle. this is your little VIP pass, the whole connection to the TI SCI layer πŸ’…
  • proc_id β€” Processor ID this request is for. like, which processor are we even talking about bestie, tell me everything
  • bv β€” Processor Boot vector (start address). the place it boots from, its little starting point 🌸
  • cfg_flags β€” Processor specific configuration flags ✨
  • ctrl_flags β€” Processor specific control flags πŸŽ€
  • sts_flags β€” Processor specific status flags 🌈

also quick reminder that bv, cfg_flags, ctrl_flags and sts_flags are all pointers β€” that's the output side of the group chat, they get filled in for you πŸ’œ

✨ RETURN ✨

0 if all went well πŸ’š β€” otherwise it returns the appropriate error value, and honestly? that's the "read at 2:47am" of return codes 😭

✨ SEE ALSO ✨

the kernel file is ./drivers/firmware/ti_sci.c β€” that's the home base, the main character's house 🏠

and now the friend group. it is a massive friend group, no cap, I'm not skipping a single one of them:

struct ti_sci_xfer(9), struct ti_sci_xfers_info(9), struct ti_sci_desc(9), struct ti_sci_irq(9), struct ti_sci_info(9), ti_sci_debug_show(9), ti_sci_debugfs_create(9), ti_sci_dump_header_dbg(9), ti_sci_rx_callback(9), ti_sci_get_one_xfer(9), ti_sci_put_one_xfer(9), ti_sci_do_xfer(9), ti_sci_cmd_get_revision(9), ti_sci_is_response_ack(9), ti_sci_set_device_state(9), ti_sci_get_device_state(9), ti_sci_cmd_get_device(9), ti_sci_cmd_get_device_exclusive(9), ti_sci_cmd_idle_device(9), ti_sci_cmd_idle_device_exclusive(9), ti_sci_cmd_put_device(9), ti_sci_cmd_dev_is_valid(9), ti_sci_cmd_dev_get_clcnt(9), ti_sci_cmd_dev_is_idle(9), ti_sci_cmd_dev_is_stop(9), ti_sci_cmd_dev_is_on(9), ti_sci_cmd_dev_is_trans(9), ti_sci_cmd_set_device_resets(9), ti_sci_cmd_get_device_resets(9), ti_sci_set_clock_state(9), ti_sci_cmd_get_clock_state(9), ti_sci_cmd_get_clock(9), ti_sci_cmd_idle_clock(9), ti_sci_cmd_put_clock(9), ti_sci_cmd_clk_is_auto(9), ti_sci_cmd_clk_is_on(9), ti_sci_cmd_clk_is_off(9), ti_sci_cmd_clk_set_parent(9), ti_sci_cmd_clk_get_parent(9), ti_sci_cmd_clk_get_num_parents(9), ti_sci_cmd_clk_get_match_freq(9), ti_sci_cmd_clk_set_freq(9), ti_sci_cmd_clk_get_freq(9), ti_sci_cmd_prepare_sleep(9), ti_sci_msg_cmd_query_fw_caps(9), ti_sci_cmd_set_io_isolation(9), ti_sci_msg_cmd_lpm_wake_reason(9), ti_sci_cmd_set_device_constraint(9), ti_sci_cmd_set_latency_constraint(9), ti_sci_cmd_lpm_abort(9), ti_sci_get_resource_range(9), ti_sci_cmd_get_resource_range(9), ti_sci_cmd_get_resource_range_from_shost(9), ti_sci_manage_irq(9), ti_sci_irq_hash(9), ti_sci_irq_equal(9), ti_sci_set_irq(9), ti_sci_free_irq(9), ti_sci_cmd_set_irq(9), ti_sci_cmd_set_event_map(9), ti_sci_cmd_free_irq(9), ti_sci_cmd_free_event_map(9), ti_sci_cmd_rm_ring_cfg(9), ti_sci_cmd_rm_psil_pair(9), ti_sci_cmd_rm_psil_unpair(9), ti_sci_cmd_rm_udmap_tx_ch_cfg(9), ti_sci_cmd_rm_udmap_rx_ch_cfg(9), ti_sci_cmd_rm_udmap_rx_flow_cfg(9), ti_sci_cmd_proc_request(9), ti_sci_cmd_proc_release(9), ti_sci_cmd_proc_handover(9), ti_sci_cmd_proc_set_config(9), ti_sci_cmd_proc_set_control(9), ti_sci_get_handle(9), ti_sci_put_handle(9), devm_ti_sci_get_handle(9), ti_sci_get_by_phandle(9), devm_ti_sci_get_by_phandle(9), ti_sci_get_free_resource(9), ti_sci_release_resource(9), ti_sci_get_num_resources(9), devm_ti_sci_get_resource_sets(9), devm_ti_sci_get_of_resource(9), devm_ti_sci_get_resource(9)

like I said. huge friend group. everyone's invited to the function party πŸŽ‰


ngl bestie, if you got a non-zero back, don't panic β€” it just means "appropriate error value" and you go check what went sideways πŸ™ˆ

and that's the whole page!! sourced from ./drivers/firmware, dated October 2026, manual ti_sci_cmd_proc_get_status(9) β€” mwah, go get that processor status, you absolute icon πŸ‘‘πŸ’…πŸ’–

πŸ“¦ where this page comes from