SMBFS(5)

💅 smbfs(5) — the SMB FS girlies need to talk 💅

okay bestie, sit down, we need to have a little chat about smbfs(5) — that's the manual page, the file formats manual one, and it's giving "vintage tech that we love but should probably not be using in 2022" energy. no cap. let's get into it 🫶

---

✨ SYNOPSIS ✨

so there's two ways to get this driver into your life, and honestly? pick your fighter.

Option one: bake it right into the kernel. compile time girlies, this one's for you. drop these lines into your kernel configuration file:

option NETSMB

Option two: the module life. load it as a module at boot time instead, and for that you put this line in loader.conf(5):

smbfs_load="YES"

slay, that's it, that's the whole synopsis 💖

---

🦋 DESCRIPTION 🦋

okay so, the SMB driver is an implementation of the CIFS (Common Internet Filesystem) network protocol. iconic concept, we love a network filesystem. ✨

but here's the part where I hold your hand, bestie. 🫶

the smbfs filesystem driver supports only the obsolete SMBv1 protocol. just SMBv1. that's the one. not the newer ones. SMBv1. 💀

and ngl, it's not great news after that:

• smbfs has known bugs 😭
• it likely has security vulnerabilities 🙈

and like, not to be dramatic, but smbfs and its userspace counterparts smbutil(1) and mount_smbfs(8) may be removed from a future version of FreeBSD. like... it's giving end of an era. it's giving sunset arc.

the actual vibe check: users are advised to evaluate the filesystems/smbnetfs port instead. that's the recommendation, straight up, no cap. go look at it. please. for me. 💅

---

🌈 SEE ALSO 🌈

the friends of the family, the supporting cast, the iykyk crew:

• smbutil(1)
• mount_smbfs(8)

---

📚 STANDARDS 📚

yes she has references, she's a scholar, she cites her sources, main character energy only 👑

Common Internet File System (CIFS) Protocol, MS-CIFS

https://docs.microsoft.com/en-us/openspecs/windows_protocols/ms-cifs/

dated December 2018.

I. Heizer, P. Leach, and D. Perry, Common Internet File System Protocol (CIFS/1.0)

https://tools.ietf.org/html/draft-heizer-cifs-v1-spec-00

dated June 13, 1996. okay 1996, that's, like, genuinely ancient, the lore goes deep 🏛️✨

---

🎀 HISTORY 🎀

the smbfs device driver first appeared in FreeBSD 4.4. a legend was born. we stan an origin story. 💜

---

🌸 AUTHORS 🌸

credit where credit is due, always, because we don't steal shine in this house:

• the smbfs device driver was written by Boris Popov <bp@FreeBSD.org> 👑
• the manual page was contributed by Gordon Bergling <gbe@FreeBSD.org> 🫶

---

and that's the whole page, bestie!! mwah!! 💖✨🎀

this little rewrite of SMBFS(5) came to you from the Debian fam, dated April 6, 2022 — and yes, that's SMBFS(5) in the corner, right where the footer always lives. bye babes, go evaluate that filesystems/smbnetfs port 🦋💅