dfs_cache_get_tgt_referral(9)

💅 dfs_cache_get_tgt_referral(9) — Kernel API Manual core ✨

okay so bestie, welcome to the dfs_cache_get_tgt_referral(9) page — yes that's the whole name, it's long, it's giving "my parents gave me all the family names" energy, but we love her 💖 this is a Kernel API Manual entry and honestly? iconic.

---

🎀 NAME 🎀

dfs_cache_get_tgt_referral — returns a DFS referral (@ref) from a given target iterator (@it). that's it, that's the whole job. she's focused, she's employed, she slays 🫶

---

✨ SYNOPSIS ✨

int dfs_cache_get_tgt_referral (const char *path , const struct
dfs_cache_tgt_iterator *it , struct dfs_info3_param *ref );

look at her. three params. no notes. 🔥

---

🦋 ARGUMENTS 🦋

• path — the canonical DFS path to look up in the DFS referral cache. like, the address of the thing, but make it canonical 💅
• it — your DFS target iterator. the little iterator bestie doing the walking 🚶‍♀️
• ref — DFS referral pointer, and this is the one you're setting up with all the gathered info. it's the main character here, we're filling her in 👑

---

🌸 DESCRIPTION 🌸

so here's the tea: return zero if the DFS referral was set up correctly 😌 otherwise you get a non-zero return, which is the kernel's way of saying "not today, babe" 😭💀

fr fr, zero = good vibes only, non-zero = something went sideways. no cap.

---

🌈 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_find(9)
• dfs_cache_noreq_find(9)
• dfs_cache_noreq_update_tgthint(9)
• dfs_cache_get_tgt_share(9)
• dfs_cache_remount_fs(9)

the whole friend group, honestly. go read them, iykyk 💜

---

and that's the page! shoutout to ./fs/smb/client for housing all of this, stamped October 2026, filed forever under dfs_cache_get_tgt_referral(9) — bestie is literally in the kernel manual, we stan a documented function 🧚⭐👑