smbinfo(1)

📦
version 7.9 · 11 versions
, in arch rolling

💅 smbinfo(1) — the manual, but make it make sense

okay so bestie, welcome to smbinfo(1), straight out of the General Commands Manual. Pull up a chair, grab a lil snack 🍓, and let's get into it.

✨ NAME ✨

smbinfo — a userspace helper that displays SMB-specific file information for the Linux SMB client file system (CIFS). yes that is the whole name, she's thorough 💅

🦋 SYNOPSIS 🦋

smbinfo [-v] [-h] [-V] {command} {file system object}

that's it. that's the whole vibe check. a couple of flags, a command, and the file system object you're being nosy about. 🎀

🌸 DESCRIPTION 🌸

okay so first things first: this tool is part of the cifs-utils suite. she's not a lone wolf, she comes with the whole friend group.

smbinfo is a userspace helper program for the Linux SMB client file system (CIFS). what she does is display SMB-specific file informations — iconic stuff like Security Descriptors and Quota. 👑

and the way it works is genuinely so cool: this tool makes a CIFS_QUERY_INFO IOCTL call to the Linux SMB client, which then issues a SMB Query Info request and hands back the result. no cap, that's the whole mechanism. 🔥

and yes, before you ask — this is different from getcifsacl, because that one uses extended file attributes instead. two different girls, two different strategies. iykyk 💅

💖 OPTIONS 💖

  • -v — print the version number and then exit. quick lil hello and she's out the door 🫶
  • -V — verbose output. she's gonna talk more. much more. (yes, lowercase -v is version and uppercase -V is verbose — not me getting those mixed up, i literally would, be careful 💀)
  • -h — print help explaining the command line options. the classic "bestie explain urself" button 😭

👑 COMMAND 👑

okay here's the menu. pick your fighter ✨

  • fileaccessinfo — prints the FileAccessInformation class
  • filealigninfo — prints the FileAlignmentInformation class
  • fileallinfo — prints the FileAllInformation class
  • filealternatenameinfo — prints the FileAlternateNameInformation class
  • filebasicinfo — prints the FileBasicInformation class
  • fileeainfo — prints the FileEaInformation class
  • filefsfullsizeinfo — prints the FileFsFullSizeInformation class
  • fileinternalinfo — prints the FileInternalInformation class
  • filemodeinfo — prints the FileModeInformation class
  • filenormalizednameinfo — prints the FileNormalizedNameInformation class
  • filepositioninfo — prints the FilePositionInformation class
  • filestandardinfo — prints the FileStandardInformation class
  • filestreaminfo — prints the FileStreamInformation class
  • filecompressioninfo — prints the FileCompressionInformation class
  • fsctl-getobjid — prints the ObjectID
  • getcompression — prints the compression setting for the file. 🗜️
  • setcompression -c <no|default|lznt1> — sets the compression setting for the file. options are no, default, or lznt1 — pick your poison 💅
  • list-snapshots — lists the previous versions of the volume that backs this file. the throwback machine 🕰️
  • quota — print the quota for the volume, in the form: SID Length - Change Time - Quota Used - Quota Threshold - Quota Limit - SID
  • secdesc — print the security descriptor, in the form: Revision - Control - Owner SID - Group SID - ACL - File types - File flags
  • keys — dump session id, encryption keys and decryption keys so that the SMB3 traffic of this mount can be decryped e.g. via wireshark. requires root. 🔐 (and yes, the manpage really does say "decryped" — i'm not fixing her, she's perfect 🙈)
  • gettconinfo — prints both the TCON Id and Session Id for a cifs file
  • notify — query a directory for change notifications 👀

🧚 NOTES 🧚

kernel support for smbinfo utilities requires the CIFS_QUERY_INFO IOCTL. that bad boy was initially introduced in the 4.20 kernel, and it's only implemented for mount points using SMB2 or above — see the mount.cifs(8) vers option if you need to check yours. ⭐

so if you're on some ancient kernel or still rocking SMB1, this is gonna be giving nothing. check ur vers, bestie. 💀

🌈 SEE ALSO 🌈

go read those too, they're literally her cousins 🫶

🎀 AUTHOR 🎀

Ronnie Sahlberg wrote the smbinfo program. absolute icon, no notes. 👑

and if you got questions about any of these programs, the Linux CIFS Mailing list is the preferred place to ask. that's where the girlies gather 💜

okay that's the whole page!! that was smbinfo(1) from the General Commands Manual, part of the cifs-utils suite — she's here, she's iconic, go query some info. slay ✨💅🦋

📦 where this page comes from