fscrypt_prepare_readdir(9)

✨ fscrypt_prepare_readdir(9) ✨

okay so welcome to the Kernel API Manual entry for fscrypt_prepare_readdir(9), bestie 💖 this one is short and iconic.

🎀 NAME 🎀

fscrypt_prepare_readdir — prepare to read a possibly-encrypted directory 🦋

🌸 SYNOPSIS 🌸

int fscrypt_prepare_readdir (struct inode *dir );

💖 ARGUMENTS 💖

• dir — the directory inode 👑 that's the directory we're prepping, periodt.

🧚 DESCRIPTION 🧚

If the directory is encrypted and it doesn't already have its encryption key set up, try to set it up so that the filenames will be listed in plaintext form rather than in no-key form. ✨

⭐ RETURN ⭐

0 on success; -errno on error. 😭

Note that the encryption key being unavailable is not considered an error. It is also not an error if the encryption policy is unsupported by this kernel; that is treated like the key being unavailable, so that files can still be deleted. 💅

🍓 SEE ALSO 🍓

• Kernel file: ./include/linux/fscrypt.h
• fscrypt_needs_contents_encryption(9)
• fscrypt_is_nokey_name(9)
• fscrypt_has_encryption_key(9)
• fscrypt_prepare_link(9)
• fscrypt_prepare_rename(9)
• fscrypt_prepare_lookup(9)
• fscrypt_prepare_setattr(9)
• fscrypt_encrypt_symlink(9)

later bestie 🫶 this page came from ./include/linux, is dated October 2026, and it's fscrypt_prepare_readdir(9) signing off 💅🎀