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) 2023 Jakub Kruszona-Zawadzki, Saglabs SA

       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)