STRUCT SGX_ENCLAVE_RUN(9)

💅 struct sgx_enclave_run(9)

okay so bestie, welcome to the Kernel API Manual ✨ like yes, we're reading kernel headers today and honestly? we're thriving. this is the whole vibe of struct sgx_enclave_run — the execution context for __vdso_sgx_enter_enclave(). it's giving "backstage pass for your enclave" 🎀

---

🌸 NAME 🌸

struct sgx_enclave_run — the execution context of __vdso_sgx_enter_enclave(). that's it, that's the whole name, and it ate 💅

---

🦋 SYNOPSIS 🦋

like, here's the struct, copied exactly, do not touch, no edits, we respect the source 💖

struct sgx_enclave_run {
    __u64 tcs;
    __u32 function;
    __u16 exception_vector;
    __u16 exception_error_code;
    __u64 exception_addr;
    __u64 user_handler;
    __u64 user_data;
    __u8 reserved[216];
 };

---

✨ Members ✨

bestie, let's go field by field, no skipping, we do not skip here 👑

• tcs — the TCS used to enter the enclave. that's the ticket they check at the door 🎟️
• function — the last seen ENCLU function, so it's one of EENTER, ERESUME or EEXIT. it's literally remembering what just happened, king behavior 👑
• exception_vector — the interrupt vector of the exception 🌈
• exception_error_code — the exception error code, pulled straight out of the stack. scooped it up ourselves, iconic 🍓
• exception_addr — the address that triggered the exception. the scene of the crime, if you will 🔥
• user_handler — a user provided callback that gets run on exception 🫶
• user_data — the data passed to the user handler. little gift bag for your callback 🎀
• reserved — reserved for future extensions. don't touch it, it's saving that seat for someone 👀

---

💜 Description 💜

okay so this is the important part, listen up 🧚

If user_handler is provided, the handler will be invoked on all return paths of the normal flow. literally all of them, no skipping, the handler is main character energy 🌟

The user handler may transfer control — e.g. via a longjmp call or a C++ exception — without returning to __vdso_sgx_enter_enclave. yep, it can just dip 💨 like it never even said bye. so don't be out here assuming it always comes back, because it fr fr might not 😭

---

🔥 SEE ALSO 🔥

the whole friend group, iykyk:

• Kernel file ./arch/x86/include/uapi/asm/sgx.h enum sgx_page_flags(9)
• struct sgx_enclave_create(9)
• struct sgx_enclave_add_pages(9)
• struct sgx_enclave_init(9)
• struct sgx_enclave_provision(9)
• struct sgx_enclave_restrict_permissions(9)
• struct sgx_enclave_modify_types(9)
• struct sgx_enclave_remove_pages(9)
• sgx_enclave_user_handler_t(9)
• vdso_sgx_enter_enclave_t(9)

---

alright bestie, that's the page 💖 huge shoutout to ./arch/x86/include/uapi/asm and the October 2026 date stamp for making this possible — mwah, slay, periodt 🫶✨💅