scmi_xfer_command_acquire(9)

💖 NAME 💖

scmi_xfer_command_acquire(9) from the Kernel API Manual is literally the helper to lookup and acquire a command xfer, bestie. Like, it finds the xfer and locks it in for you. slay. ✨

✨ SYNOPSIS ✨

struct scmi_xfer * scmi_xfer_command_acquire (struct scmi_chan_info
       *cinfo , u32 msg_hdr );

🎀 ARGUMENTS 🎀

• cinfo — a reference to the channel descriptor. the channel's lil info bestie 💅
• msg_hdr — a message header to use as lookup key. the key you're searching with 🔑

🦋 DESCRIPTION 🦋

Okay so picture this: when a valid xfer is found for the sequence number embedded in the provided msg_hdr, the reference counting is properly updated, and exclusive access to this xfer is granted till it's released with scmi_xfer_command_release. That's the whole vibe — lookup, refcount update, exclusive access, release later. no cap. 💖

🌸 RETURN 🌸

A valid xfer on Success, or an error otherwise. periodt. 😭

💜 SEE ALSO 💜

The kernel file is ./drivers/firmware/arm_scmi/driver.c, and here's the whole icon squad:

• struct scmi_xfers_info(9)
• struct scmi_protocol_instance(9)
• struct scmi_info(9)
• scmi_create_protocol_devices(9)
• scmi_xfer_token_set(9)
• scmi_xfer_token_clear(9)
• scmi_xfer_inflight_register_unlocked(9)
• scmi_xfer_inflight_register(9)
• scmi_xfer_raw_inflight_register(9)
• scmi_xfer_pending_set(9)
• scmi_xfer_get(9)
• scmi_xfer_raw_get(9)
• scmi_xfer_raw_channel_get(9)
• __scmi_xfer_put(9)
• scmi_xfer_raw_put(9)
• scmi_xfer_lookup_unlocked(9)
• scmi_bad_message_trace(9)
• scmi_msg_response_validate(9)
• scmi_xfer_state_update(9)
• scmi_rx_callback(9)
• xfer_put(9)
• scmi_wait_for_message_response(9)
• scmi_xfer_raw_wait_for_message_response(9)
• do_xfer(9)
• do_xfer_with_response(9)
• xfer_get_init(9)
• version_get(9)
• scmi_set_protocol_priv(9)
• scmi_get_protocol_priv(9)
• scmi_common_extended_name_get(9)
• scmi_common_get_max_msg_size(9)
• scmi_protocol_msg_check(9)
• struct scmi_iterator(9)
• scmi_revision_area_get(9)
• scmi_protocol_version_negotiate(9)
• scmi_protocol_version_initialize(9)
• scmi_alloc_init_protocol_instance(9)
• scmi_get_protocol_instance(9)
• scmi_protocol_acquire(9)
• scmi_protocol_release(9)
• scmi_devm_protocol_get(9)
• scmi_devm_protocol_acquire(9)
• scmi_devm_protocol_put(9)
• scmi_is_transport_atomic(9)
• scmi_handle_get(9)
• scmi_handle_put(9)
• scmi_channels_setup(9)

source/version vibes: ./drivers/firmware/arm_scmi, October 2026, scmi_xfer_command_acquire(9). byeee bestie 🫶💖