summaryrefslogtreecommitdiff
path: root/smb2-quota.rst
blob: 508b8748b41009dee94728d53a62b2d0f40de97b (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
============
smb2-quota
============

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

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

  smb2-quota [-h] {options} {file system object}

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

This tool is part of the cifs-utils suite.

`smb2-quota` is a userspace helper program for the Linux SMB
client file system (CIFS).

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.

*******
OPTIONS
*******
`--help/-h`: Print help explaining the command line options.

`--tabular/-t`: Print quota information for the volume in tabular format.
Amount Used | Quota Limit | Warning Level | Percent Used | Status | SID

`--csv/-c`: Print quota information for the volume in csv format.
SID,Amount Used,Quota Limit,Warning Level

`--list/-l`: Print quota information for the volume in raw format.
- SID
- Quota Used
- Quota Threshold
- Quota Limit

`--tabular/-t` is the default action if none is given.

*****
NOTES
*****

Kernel support for smb2-quota 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
********

smbinfo(1)

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

Kenneth D'souza <kdsouza@redhat.com>

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