mfsquota "1" "August 2021" "MooseFS 3.0.116-1" "This is part of MooseFS"
NAME
mfsquota - MooseFS quota management tools
SYNOPSIS
mfsgetquota [-n|-h|-H|-k|-m|-g]
DIRECTORY...
mfssetquota [-n|-h|-H|-k|-m|-g] [-p grace_period] [-i|-I inodes] [-l|-L length] [-s|-S size] [-r|-R realsize] DIRECTORY...
mfsdelquota [-a|-A|-i|-I|-l|-L|-s|-S|-r|-R] [-n|-h|-H|-k|-m|-g] -f DIRECTORY...
mfscopyquota [-n|-h|-H|-k|-m|-g] SOURCE_DIRECTORY DESTINATION_DIRECTORY
DESCRIPTION
These tools are used to check, define and delete quotas. Quota is set on a directory. It can be set in one
of 4 ways: for number of inodes inside the directory (total sum of the
subtree's inodes) with -i, -I options, for sum of (logical) file lengths with
-l, -L options,
for sum of chunk sizes (not considering goals) with -s, -S options and for physical
hdd space (more or less chunk sizes multiplied by goal of each chunk) with -r, -R options.
Small letters set soft quota, capital letters set hard quota. -a and -A options in
mfsdelquota mean all kinds of quota. Quota behaviour is described below.
For soft quota grace period can be defined using -p option. When grace period is not given then
default value will be used (option defined in mfsmaster.cfg or seven days if it's not defined there).
Quota is always set on a directory. Hard quota cannot be exceeded anytime. Soft quota can be exceeded for a specified period of time. Once a quota is exceeded in a directory, user must go below the quota during the grace period. If not, the soft quota for this particular directory starts to behave like a hard quota.
GENERAL OPTIONS
Most of mfstools use -n, -h, -H, -k, -m and -g
options to select
format of printed numbers. -n causes to print exact numbers, -h
uses binary prefixes (Ki, Mi, Gi as 2^10, 2^20 etc.) while -H uses SI
prefixes (k, M, G as 10^3, 10^6 etc.). -k, -m and -g show plain numbers
respectivaly in kibis (binary kilo - 1024), mebis (binary mega - 1024^2)
and gibis (binary giga - 1024^3).
The same can be achieved by setting
MFSHRFORMAT environment variable to: 0 (exact numbers), 1
or h (binary prefixes), 2 or H (SI prefixes), 3 or
h+ (exact numbers and binary prefixes), 4 or H+ (exact
numbers and SI prefixes). The default is to print just exact numbers.
"REPORTING BUGS"
Report bugs to <bugs@moosefs.com>.
COPYRIGHT
Copyright (C) 2021 Jakub Kruszona-Zawadzki, Core Technology Sp. z o.o.
This file is part of MooseFS.
MooseFS is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 2 (only).
MooseFS is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with MooseFS; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA
or visit http://www.gnu.org/licenses/gpl-2.0.html
"SEE ALSO"
mfsmount (8), mfstools (1)