btrfs quota <subcommand> <args>
The commands under :command:`btrfs quota` are used to affect the global status of quotas of a btrfs filesystem. The quota groups (qgroups) are managed by the subcommand :doc:`btrfs-qgroup`.
Note
Qgroups are different than the traditional user quotas and designed to track shared and exclusive data per-subvolume. Please refer to the section :ref:`HIERARCHICAL QUOTA GROUP CONCEPTS<man-quota-hierarchical-quota-group-concepts>` for a detailed description.
When quotas are activated, they affect all extent processing, which takes a performance hit. Activation of qgroups is not recommended unless the user intends to actually use them.
The qgroup implementation has turned out to be quite difficult as it affects the core of the filesystem operation. Qgroup users have hit various corner cases over time, such as incorrect accounting or system instability. The situation is gradually improving and issues found and fixed.
- disable <path>
- Disable subvolume quota support for a filesystem.
- enable [options] <path>
Enable subvolume quota support for a filesystem. At this point it's possible the two modes of accounting. The full means that extent ownership by subvolumes will be tracked all the time, simple will account everything to the first owner. See the section for more details.
Options- -s|--simple
- use simple quotas (squotas) instead of full qgroup accounting
- rescan [options] <path>
Trash all qgroup numbers and scan the metadata again with the current config.
Options- -s|--status
- show status of a running rescan operation.
- -w|--wait
- start rescan and wait for it to finish (can be already in progress)
- -W|--wait-norescan
- wait for rescan to finish without starting it
btrfs quota returns a zero exit status if it succeeds. Non zero is returned in case of failure.
btrfs is part of btrfs-progs. Please refer to the documentation at https://btrfs.readthedocs.io.
:doc:`btrfs-qgroup`, :doc:`btrfs-subvolume`, :doc:`mkfs.btrfs`