nfsd_readdir(9)

✨ nfsd_readdir(9) — the Kernel API Manual tea ✨

Okay bestie, so you've stumbled into the kernel API manual — welcome, this one's called nfsd_readdir and it literally does what it says on the tin: reads entries from a directory. No cap. 🎀

---

🌸 NAME 🌸

nfsd_readdir — read entries from a directory 💅

---

✨ SYNOPSIS ✨

__be32 nfsd_readdir (struct svc_rqst *rqstp , struct svc_fh *fhp ,
loff_t *offsetp , struct readdir_cd *cdp , nfsd_filldir_t func );

---

🦋 ARGUMENTS 🦋

• rqstp — the RPC transaction context. the vibe of the whole call, basically 🫶
• fhp — the NFS file handle of the directory we're about to read 👑
• offsetp — OUT: the seek offset of the final entry that was read. it hands that number back to you ✨
• cdp — OUT: an eof error value, dropped right in there 🌈
• func — the entry filler actor. the little main character that actually does the filling 💫

---

💖 DESCRIPTION 💖

So this implementation ignores the NFSv3/4 verifier cookie. Not a typo, not a bug note — it just doesn't use it. periodt. 🙈

NB (no cap, this one matters): normal system calls hold file->f_pos_lock when calling ->iterate_shared and ->llseek, but nfsd_readdir does not. And like... that's fine here, because the struct file acquired here is not visible to other threads, so its internal state does not need mutex protection. the way that works out 😌

Returns nfs_ok on success, otherwise an nfsstat code comes back at you. 🔥

(also yes, the original says "it's internal state" and we are not fixing the apostrophe, we are simply living with it 💀)

---

🧚 SEE ALSO 🧚

Kernel file ./fs/nfsd/vfs.c, plus the whole friend group:

nfserrno(9), nfsd_lookup(9), nfsd_setattr(9), nfsd4_is_junction(9), nfsd_open_verified(9), nfsd_splice_read(9), nfsd_iter_read(9), nfsd_vfs_write(9), nfsd_read_splice_ok(9), nfsd_read(9), nfsd_write(9), nfsd_commit(9), nfsd_create_setattr(9), nfsd_symlink(9), nfsd_link(9), nfsd_rename(9), nfsd_unlink(9), nfsd_filp_close(9), nfsd_removexattr(9), nfsd_get_case_info(9) 🌸

---

Okay that's the whole page, you ate that 🍓 — this little baddie lives in ./fs/nfsd and the docs are stamped October 2026. go read a directory, bestie, you've earned it 💜🦋✨