summaryrefslogtreecommitdiff
path: root/smbinfo.rst
blob: 7413849ce13f4e4ba41cc35abd35eae6badca564 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
============
smbinfo
============

-----------------------------------------------------------------------------------------------------
Userspace helper to display SMB-specific file information for the Linux SMB client file system (CIFS)
-----------------------------------------------------------------------------------------------------
:Manual section: 1

********
SYNOPSIS
********

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

***********
DESCRIPTION
***********

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

`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

`filepositioninfo`: Prints the FilePositionInformation class

`filestandardinfo`: Prints the FileStandardInformation 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).

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

********
SEE ALSO
********

mount.cifs(8), getcifsacl(1)

******
AUTHOR
******

Ronnie Sahlberg wrote the smbinfo program.

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