SMBUTIL(1)

💅 SMBUTIL(1) — the girlies' guide to the SMB requester ✨

okay so first things first, bestie: this is smbutil(1) from the General Commands Manual, and it's literally your interface to the server message block (SMB1/CIFS) requester. yes, that old one. she's vintage, she's iconic, we love her 💖

---

🌸 SYNOPSIS 🌸

smbutil [-hv] command [options] [args]

like, that's the whole vibe. one tool, a bunch of commands, go off 👑

---

✨ DESCRIPTION ✨

so smbutil is the command you use to control the SMB requester and fire off various commands at it. it's giving main character energy for the whole SMB situation 🫶

here's the thing you gotta know: there are two types of options — global ones, and local ones that only belong to the specific command you picked. do not mix them up, i'm begging 😭

⭐ Global options (these go with everything)

• -h — prints a short help message. the "help me help you" flag 💀
• -v — verbose output. she's chatty, she tells you everything 🗣️

🎀 The commands & their local options

• crypt [password] — encrypts a clear text password for use in the ~/.nsmbrc file. the encrypted password starts with the ‘$$1’ symbols. > ⚠️ warning, bestie: the encryption function is very weak and is intended only to hide clear text password. it's a curtain, not a vault, ok? 🙈 if password is omitted from the command line, smbutil will prompt for one. so you don't have to paste your secrets into your shell history like a menace 💅
• help command — prints usage information about command. that's it. that's the whole gig ✨
• lc — lists active connections and their parameters. lowkey the most useful one ngl, it's the "who's connected rn" check 👀
• login [connection_options] //user@server[/share] — logs in / attaches to the specified server and/or share as user. this command will create and authenticate a connection to an SMB server, and will leave it active after exit. so like — you can login only once and then use other SMB commands without authentication procedure and additional connections. one and done, slay 👑 for the description of connection_options refer to the mount_smbfs(8) manual page (all uppercase options are connection options). yes, ALL UPPERCASE = connection options, that's the rule, iykyk 🔥
• logout //user@server[/share] — logout / detach from the specified server and/or share as user. this command will destroy a connection created by the login command. > 🫶 heads up: a connection may not be closed immediately if it is used by other programs. she's not ghosting you on purpose, she's just busy 💀
• lookup [-w host] name — resolves the given name to an IP address. the NetBIOS name server can be directly specified via the -w option. it's giving "who is she" but with DNS energy 🦋
• print [connection_options] //user@server[/share] file — sends the given file to the specified queue on the remote server. and if file is “-”, then standard input will be used. pipe it, bestie 🍓
• view [connection_options] //user@server — lists resources available on the specified server for the user user. window shopping but make it network 🎀

---

🦋 FILES 🦋

• ~/.nsmbrc — keeps description for each connection. see /usr/share/examples/smbfs/dot.nsmbrc for details. it's the little notebook where your connections live 💜

---

🌈 SEE ALSO 🌈

nsmb.conf(5), mount_smbfs(8)

go read those too, they're the supporting cast and honestly they ate 💅

---

👑 AUTHORS 👑

Boris Popov <bp@butya.kz>, ⟨bp@FreeBSD.org⟩

we stan a legend 🫶

---

💀 BUGS 💀

please report any bugs to the author. don't suffer in silence, tell him directly, periodt 📣

---

✨ and that's the whole page, bestie ✨ this little gem comes to you from Debian, dated November 14, 2018 — SMBUTIL(1), forever iconic, no cap 🎀💖