scmi_devm_protocol_acquire(9)

💖 NAME 💖

okay bestie, welcome to the Kernel API Manual page for scmi_devm_protocol_acquire(9) — the devres-managed helper that gets you hold of a protocol. ✨

✨ SYNOPSIS ✨

int scmi_devm_protocol_acquire (struct scmi_device *sdev , u8
       protocol_id );

🎀 ARGUMENTS 🎀

• sdev — a reference to an scmi_device whose embedded struct device is the one used for devres accounting. 🫶
• protocol_id — the protocol being requested. 💅

🦋 DESCRIPTION 🦋

So this one gets you hold of a protocol and accounts for its usage. It may possibly trigger the protocol’s initialization, but it does not give you access to its protocol specific operations and handle. 😌

Because it’s a devres based managed method, the protocol hold will be automatically released — and possibly de-initialized on the last user — once the SCMI driver that owns the scmi_device is unbound from it. periodt. 💫

💖 RETURN 💖

• 0 on SUCCESS 🌟

🔥 SEE ALSO 🔥

Kernel file ./drivers/firmware/arm_scmi/driver.c — plus all these cross-reference besties, no cap:

• 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_xfer_command_acquire(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_put(9)
• scmi_is_transport_atomic(9)
• scmi_handle_get(9)
• scmi_handle_put(9)
• scmi_channels_setup(9)

💅 kisses bestie — this page’s source spot is ./drivers/firmware/arm_scmi, the version vibe is scmi_devm_protocol_acquire(9), and it’s dated October 2026. mwah 🫶