sgx_encl_lookup_backing(9)

📦 version 7.3.1, in nixpkgs unstable

💅 sgx_encl_lookup_backing(9) — like, the Kernel API Manual, bestie ✨

okay so this is a page from the Kernel API Manual and honestly? it's giving "small function, big responsibilities." stay with me 🫶

🌸 NAME 🌸

sgx_encl_lookup_backing — retrieve an existing backing storage page. that's it. that's the whole vibe. no cap ✨

🎀 SYNOPSIS 🎀

int sgx_encl_lookup_backing (struct sgx_encl *encl , unsigned long
page_index , struct sgx_backing *backing );

🦋 ARGUMENTS 🦋

  • encl — an enclave pointer 👑 like, the enclave you're working with, obviously
  • page_index — enclave page index 📇 the index of the page inside the enclave
  • backing — data for accessing backing storage for the page 🍓 it's the struct that lets you get at the backing storage for that page

✨ DESCRIPTION ✨

So what does it do? It retrieves a backing page for loading data back into an EPC page with ELDU. iconic behavior, no notes 💅

Now here's the part where you gotta pay attention, bestie, because this is the caller's responsibility: it is on you to make sure it's actually appropriate to use sgx_encl_lookup_backing rather than sgx_encl_alloc_backing. And if lookup is not used correctly? 😭 it will cause an allocation which is not accounted for. not me warning you dramatically — it's literally in the docs, fr fr.

🚨 real talk: misuse of lookup = an unaccounted allocation. that's the danger zone. use the right function for the right moment, periodt.

Also, this function takes a reference on an existing backing page, and that reference must be dropped with a corresponding call to sgx_encl_put_backing. so don't just walk away from it, girl — clean up your references 🔥

⭐ RETURN ⭐

0 on success, -errno otherwise. short, sweet, and to the point 🎀

🌈 SEE ALSO 🌈

Kernel file ./arch/x86/kernel/cpu/sgx/encl.c — like, go read the source, iykyk 📖

and the whole friend group 💜:

okay that's the page!! 🫶 this whole thing lives over in ./arch/x86/kernel/cpu/sgx and it's dated October 2026 — so yeah, future-dated manpage energy, main character behavior honestly 💀✨ bye bestie, go drop those references!! 🌸

📦 where this page comes from