STRUCT SGX_ENCLAVE_REMOVE_PAGES(9)

💅 struct sgx_...remove_pages(9) — Kernel API Manual 🎀

okay bestie so this page is from the Kernel API Manual, and it's all about struct sgx_enclave_remove_pages — the parameter block for %SGX_IOC_ENCLAVE_REMOVE_PAGES. yes the % is literally part of the name, we don't make the rules 💖

---

✨ NAME ✨

struct sgx_enclave_remove_pages — the parameter struct for %SGX_IOC_ENCLAVE_REMOVE_PAGES, no cap 🫶

---

🌸 SYNOPSIS 🌸

struct sgx_enclave_remove_pages {
    __u64 offset;
    __u64 length;
    __u64 count;
 };

look at her, three __u64s and a dream ✨

🦋 Members 🦋

• offset — the starting page offset. it's page aligned and it's relative to the enclave base address that's defined in SECS, okay? don't forget the SECS part, iykyk 💅
• length — how long the memory is. must be a multiple of the page size, periodt 🔥
• count — this one's (output)! it's how many bytes were successfully changed, and yup, also a multiple of page size 💖

---

👑 Description 👑

so here's the vibe: regular pages (PT_REG) or TCS pages (PT_TCS) can be removed from an initialized enclave — but only if the system supports SGX2. that's the vibe check right there, no cap 😭

the order of operations is literally sacred, do not freestyle this:

1. first, hit the SGX_IOC_ENCLAVE_MODIFY_TYPES ioctl to change the page type to PT_TRIM 🎀
2. once that succeeds, run ENCLU[EACCEPT] from within the enclave 🧚
3. and then SGX_IOC_ENCLAVE_REMOVE_PAGES can be used to complete the page removal ✨

bestie please do these in order. skip a step and it's giving chaos 💀

---

🌈 SEE ALSO 🌈

• 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)
• sgx_enclave_user_handler_t(9)
• struct sgx_enclave_run(9)
• vdso_sgx_enter_enclave_t(9)

---

and that's the whole page, bestie 💜 this one lives at ./arch/x86/include/uapi/asm and it's dated October 2026 — go read it again, it's iconic 🎀✨