SSAM_DEFINE_SYNC_REQUEST_N(9)

👑 NAME 💅

SSAM_DEFINE_SYNC_REQUEST_N — bestie, this is straight from the Kernel API Manual, section 9, and it's the macro that defines a synchronous SAM request function with neither argument nor return value. Iconic zero-arg, zero-return behavior. 🎀

✨ SYNOPSIS ✨

SSAM_DEFINE_SYNC_REQUEST_N (name , spec... );

🎀 ARGUMENTS 🎀

• name — the name of the generated function. That's its whole identity, no cap.
• spec — the specification (struct ssam_request_spec) that defines the request. It's giving request recipe card. 🍓

💖 DESCRIPTION 💖

So this macro defines a function that executes the synchronous SAM request specified by spec, and the request has neither argument nor return value. The generated function handles setting up the request struct and buffer allocation, plus executing the request itself, and it returns once the request has been fully completed. The required transport buffer will be allocated on the stack — yes bestie, stack, for real. 🫶

The generated function is defined as static int name(struct ssam_controller *ctrl). It returns the status of the request, which is zero on success and negative on failure. The ctrl parameter is the controller via which the request is being sent. Slay. 🌈

Refer to ssam_request_do_sync_onstack for more details on the behavior of the generated function.

🌸 SEE ALSO 🌸

• Kernel file ./include/linux/surface_aggregator/controller.h
• enum ssam_event_flags(9)
• struct ssam_event(9)
• enum ssam_request_flags(9)
• struct ssam_request(9)
• struct ssam_response(9)
• struct ssam_request_sync(9)
• ssam_request_sync_set_data(9)
• ssam_request_sync_set_resp(9)
• ssam_request_sync_wait(9)
• ssam_request_do_sync_onstack(9)
• __ssam_retry(9)
• ssam_retry(9)
• struct ssam_request_spec(9)
• struct ssam_request_spec_md(9)
• SSAM_DEFINE_SYNC_REQUEST_W(9)
• SSAM_DEFINE_SYNC_REQUEST_R(9)
• SSAM_DEFINE_SYNC_REQUEST_WR(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_N(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_W(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_R(9)
• SSAM_DEFINE_SYNC_REQUEST_MD_WR(9)
• enum ssam_notif_flags(9)
• struct ssam_notifier_block(9)
• ssam_notifier_from_errno(9)
• ssam_notifier_to_errno(9)
• struct ssam_event_registry(9)
• struct ssam_event_id(9)
• enum ssam_event_mask(9)
• SSAM_EVENT_REGISTRY(9)
• enum ssam_event_notifier_flags(9)
• struct ssam_event_notifier(9)
• ssam_notifier_unregister(9)

💖 That's the whole page, bestie — source/version ./include/linux/surface_aggreg..., dated October 2026. Mwah! 💅🎀