smbinfo(1)

smbinfo1

Userspace helper to display smb-specific file information for the linux smb client file system (cifs)

Usage

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

Overview

This tool is part of the cifs-utils suite.

smbinfo is a userspace helper program for the Linux SMB client file system (CIFS). It is intended to display SMB-specific file informations such as Security Descriptors and Quota.

This tool works by making an CIFS_QUERY_INFO IOCTL call to the Linux SMB client which in turn issues a SMB Query Info request and returns the result. This differs from getcifsacl which uses extended file attributes.

Options

-v

Print version number and exit.

-V

Verbose output.

-h

Print help explaining the command line options.

Command

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.

list-snapshots: Lists the previous versions of the volume that backs this file

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).

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 which was initially introduced in the 4.20 kernel and is only implemented for mount points using SMB2 or above (see mount.cifs(8) vers option).

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

Author

Ronnie Sahlberg wrote the smbinfo program.

The Linux CIFS Mailing list is the preferred place to ask questions regarding these programs.

From cifs-utils 7.9-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.