dfs_cache_find(9)

💅 dfs_cache_find(9) — bestie's guide to the Kernel API Manual

okay so this one lives in the kernel API manual and it's literally called dfs_cache_find — the whole vibe is "find a DFS cache entry" ✨ she's a lookup girlie and she ate, no cap.

---

🌸 SYNOPSIS 🌸

int dfs_cache_find (const unsigned int xid , struct cifs_ses *ses ,
const struct nls_table *cp , int remap , const char *path ,
struct dfs_info3_param *ref , struct dfs_cache_tgt_list *tgt_list );

like… seven whole parameters, she's high maintenance but she delivers 💅

---

🎀 ARGUMENTS 🎀

• xid — the syscall xid. it's giving ✨identifier energy✨
• ses — the smb session you're issuing the request on 🫶
• cp — codepage. yes bestie, a codepage.
• remap — the path character remapping type 🔥
• path — the path to look up in the DFS referral cache. this is the main character fr.
• ref — when non-NULL, store a single DFS referral result in it. when NULL? she minds her business 🙈
• tgt_list — when non-NULL, store the complete DFS target list in it. again, non-NULL only, iykyk 💀

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓 — if it doesn't find the cache entry, then it will get a DFS referral for path and create a new entry. fresh out the oven, brand new, iconic.

in case the cache entry exists but is expired 👑 (we've all been there), it will get a DFS referral for path and then update the respective cache entry. glow-up, essentially.

these parameters are passed down to the get_dfs_refer call if it needs to be issued:

and then — the moment we've all been waiting for — return zero if the target was found, otherwise non-zero. that's it, that's the return value, periodt. ⭐

ngl, the "these parameters are passed down to the get_dfs_refer call" line stands on its own in the original, so we're leaving it exactly where it is — no edits, no adding, we don't invent lore here 🙅‍♀️

---

💖 SEE ALSO 💖

• Kernel file ./fs/smb/client/dfs_cache.c
• dfs_cache_canonical_path(9)
• dfs_cache_init(9)
• dfs_cache_destroy(9)
• dfs_cache_noreq_find(9)
• dfs_cache_noreq_update_tgthint(9)
• dfs_cache_get_tgt_referral(9)
• dfs_cache_get_tgt_share(9)
• dfs_cache_remount_fs(9)

the whole friend group 🫶 honestly obsessed.

---

mwah 💋 this princess came from ./fs/smb/client, dated October 2026, and she's filed under dfs_cache_find(9) — catch her in the Kernel API Manual, k bye 🧚‍♀️✨