smb2-quota(1)

πŸ’… smb2-quota(1) β€” the group-chat guide

okay so bestie, welcome to smb2-quota, a General Commands Manual girly whose whole personality is userspace helper to display quota information for the Linux SMB client file system (CIFS). yes that's her job title. she's booked and busy πŸ’–


✨ SYNOPSIS ✨

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

that's it. that's the whole vibe check. {file system object} is the main character, the flags are the supporting cast πŸŽ€


🌸 DESCRIPTION 🌸

so this tool is literally part of the cifs-utils suite β€” she's not out here alone, she's got a whole friend group 🫢

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

and how does she work her magic? okay so she makes a CIFS_QUERY_INFO IOCTL call to the Linux SMB client, and the client is like "say less," issues a SMB Query Info request, and returns the result right back to her. the way she just delegates πŸ’… no cap, that's the entire pipeline.


πŸ¦‹ OPTIONS πŸ¦‹

  • --help, -h β€” prints help explaining the command line options. the "hi what do u do" of flags 🌈
  • --tabular, -t β€” prints quota information for the volume in tabular format. the layout, exactly: Amount Used | Quota Limit | Warning Level | Percent Used | Status | SID ✨
  • --csv, -c β€” prints quota information for the volume in csv format. the fields, exactly: SID,Amount Used,Quota Limit,Warning Level πŸ“
  • --list, -l β€” prints quota information for the volume in raw format. the items, exactly: - SID - Quota Used - Quota Threshold - Quota Limit 🌸
πŸ‘‘ heads up bestie: --tabular/-t is the default action if none is given. she has a favorite and she's not hiding it.

πŸ’œ NOTES πŸ’œ

okay this part is the serious one, gather round πŸ™ˆ

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 the vers option in mount.cifs(8). so if your kernel is ancient or your mount is speaking vintage, this is gonna be giving nothing πŸ’€


⭐ SEE ALSO ⭐

smbinfo(1) β€” her sibling. go say hi πŸŽ€


🌈 AUTHOR 🌈

Kenneth D'souza <kdsouza@redhat.com> β€” legend behavior, we stan πŸ’–

the Linux CIFS Mailing list is the preferred place to ask questions regarding these programs. that's the group chat, that's where the lore lives 🫢


and that's the page!! mwah πŸ’‹ this was smb2-quota(1) from the General Commands Manual β€” part of the cifs-utils suite, no date or version girlies in sight, just pure quota-displaying excellence. slay, periodt, go check your quotas bestie βœ¨πŸ’…πŸŽ€

πŸ“¦ where this page comes from