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)