fscrypt_fname_encrypt(9)

📦 version 7.3.1, in nixpkgs unstable

💅 fscrypt_fname_encrypt — encrypt a filename

okay so this is a page from the Kernel API Manual (yes, the kernel has lore too, bestie) and honestly? it's giving "small function, big responsibilities" 🔥

✨ NAME ✨

fscrypt_fname_encrypt — literally just: encrypt a filename 💖 that's the whole vibe.

🎀 SYNOPSIS 🎀

int fscrypt_fname_encrypt(const struct inode *inode, const struct qstr *iname,
                          u8 *out, unsigned int olen);

🦋 ARGUMENTS 🦋

  • inode — the inode of the parent directory (for regular filenames), or of the symlink (for symlink targets). heads up: the key must already be set up before you call this, no cap 🔑✨
  • iname — the filename you wanna encrypt. the main character, the one we're protecting 🫶
  • out — (output) the encrypted filename goes here. this is where the slay happens 💅
  • olen — the size of the encrypted filename. it must be at least iname->len. any extra space gets filled with NUL padding before encryption, so don't be weird about it 🙈

🌸 RETURN 🌸

  • 0 on success — iconic, we ate 👑
  • -errno on failure — 😭 not the errno

🌈 SEE ALSO 🌈

like, the whole friend group fr fr 🧚💜 go read them, iykyk

💀 reminder bestie: olen must be at least iname->len. this is not a suggestion, it's the law. the extra bytes get NUL-padded before encryption, so keep that in mind before you come for this function.

and that's the whole page, periodt 🎀 this came out of ./fs/crypto in October 2026, so go be obsessed responsibly ⭐💖

📦 where this page comes from