pcc_mbox_request_channel(9)

💖 NAME 💖

okay so bestie, welcome to pcc_mbox_request_channel(9) from the Kernel API Manual ✨ PCC clients call this function when they need to request a pointer to their PCC subspace — that's the spot where they get the deets for communicating with the remote. no cap, it's giving “let me find my mailbox portal” energy 🎀

🌸 SYNOPSIS 🌸

struct pcc_mbox_chan * pcc_mbox_request_channel (struct mbox_client *cl
, int subspace_id );

✨ ARGUMENTS ✨

• cl — pointer to the Mailbox client, so we know where to bind the Channel 🫶
• subspace_id — the PCC Subspace index as parsed in the PCC client ACPI package. This is used to lookup the array of PCC subspaces as parsed by the PCC Mailbox controller 💅

🎀 RETURN 🎀

If it's a slay, you get a pointer to the PCC Mailbox Channel. If not, it's ERR_PTR 😭

🦋 SEE ALSO 🦋

Kernel file ./drivers/mailbox/pcc.c — plus these iconic little references:

• struct pcc_chan_reg(9)
• struct pcc_chan_info(9)
• pcc_map_interrupt(9)
• pcc_mbox_irq(9)
• pcc_mbox_free_channel(9)
• pcc_send_data(9)
• pcc_startup(9)
• pcc_shutdown(9)
• parse_pcc_subspace(9)
• pcc_parse_subspace_irq(9)
• pcc_parse_subspace_db_reg(9)
• pcc_parse_subspace_shmem(9)
• acpi_pcc_probe(9)
• pcc_mbox_probe(9)

xoxo, this pcc_mbox_request_channel(9) page comes from ./drivers/mailbox, dated October 2026 — mwah, periodt 💋💜