cifs_get_tcon(9)

💖 cifs_get_tcon(9) 💖

okay so welcome to the Kernel API Manual bestie, this one's a kernel function page and it's lowkey a refcounting girlie 🎀

---

✨ NAME ✨

cifs_get_tcon — get a tcon matching @ctx data from @ses 💅

---

🦋 SYNOPSIS 🦋

struct cifs_tcon * cifs_get_tcon (struct cifs_ses *ses , struct
       smb3_fs_context *ctx );

---

🌸 ARGUMENTS 🌸

• ses — the smb session to issue the request on 🫶
• ctx — the superblock configuration context to use for building the

yes bestie the original sentence just trails off there, we don't make the rules, we just report them 🙈

---

⭐ DESCRIPTION ⭐

so here's the situation, and it's giving refcount bookkeeping 🔥

• the tcon refcount is literally the number of mount points using the tcon
• the ses refcount is the number of tcon using the session

1. this function assumes it is being called from cifs_mount where we already got a session reference (ses refcount +1) 💀
2. since we're in the context of adding a mount point, the end result should be either:

a) a new tcon already allocated with refcount=1 (1 mount point) and its session refcount incremented (1 new tcon). this +1 was already done in (1) ✨

b) an existing tcon with refcount+1 (add a mount point to it) and identical ses refcount (no new tcon). because of (1) we need to decrement the ses refcount 👑

---

💜 SEE ALSO 💜

• Kernel file ./fs/smb/client/connect.c cifs_setup_ipc(9), cifs_get_smb_ses(9) 🧚

---

and that's the whole page bestie, no cap 🍓 this icon came from ./fs/smb/client and it's dated October 2026 — periodt, go forth and refcount responsibly 💖🌈