LFS-SETQUOTA(1)

NAME
lfs-setquota - set quota limits or grace time for users, groups or projects.

SYNOPSIS
lfs setquota {-u|--user|-g|--group|-p|--projid} UID|GID|PROJID
       [--pool POOLNAME ]
       [--block-softlimit|-b BLOCK_SOFTLIMIT[kMGTPE]]
       [--block-hardlimit|-B BLOCK_HARDLIMIT[kMGTPE]]
       [--inode-softlimit|-i INODE_SOFTLIMIT[kMGTPE]]
       [--inode-hardlimit|-I INODE_HARDLIMIT[kMGTPE]] <filesystem>

lfs setquota -t {-h|-u|-g|-p}
           [--pool POOL_NAME]
           [--block-grace|-b BLOCK_GRACE_TIME]
           [--inode-grace|-i INODE_GRACE_TIME] <filesystem>

lfs setquota {-u|--user|-g|--group|-p|--projid} UID|GID|PROJID
           [--default|-D] <filesystem>

lfs setquota {-U|--default-usr|-G|--default-grp|-P|--default-prj}
           [--block-softlimit|-b BLOCK_SOFTLIMIT[kMGTPE]]
           [--block-hardlimit|-B BLOCK_HARDLIMIT[kMGTPE]]
           [--inode-softlimit|-i INODE_SOFTLIMIT[kMGTPE]]
           [--inode-hardlimit|-I INODE_HARDLIMIT[kMGTPE]] <filesystem>

lfs setquota {-u|--user|-g|--group|-p|--projid} UID|GID|PROJID
           [--delete] <filesystem> lfs setquota {-u|--user|-g|--group|-p|--projid} UID|GID|PROJID
           [-r] <filesystem>

DESCRIPTION

lfs setquota {-u|-g|-p}
    Command sets the filesystem quotas for users, groups or projects respectively. Block limits unit is kilobyte (1024) by default and block limits are always kilobyte-grained (even if specified in bytes), block limits can be specified with a k,M,G,T,P, or E suffixes which specify units of 2^10, 2^20, 2^30, 2^40, 2^50 and 2^60 accordingly.

-b|--block-softlimitBLOCK_SOFTLIMIT
    Specify block softlimit, zero means unlimited.

-B|--block-hardlimitBLOCK_HARDLIMIT
    Specify block hardlimit, zero means unlimited. The block hardlimit should be greater than block softlimit when it's being specified.

--delete
    Delete the unused UID|GID|PROJID.

-D|--default
    Set user/group/project to use the default quota limits.

-g|--groupGROUPNAME|GID
    Set group quota for name GROUPNAME or GID.

-h|--help
    Print usage message.

-i|--inode-softlimitINODE_SOFTLIMIT
    Specify inode softlimit, zero means unlimited.

-I|--inode-hardlimit INODE_HARDLIMIT
    Specify inode hardlimit, zero means unlimited. The inode hardlimit should be greater than inode softlimit when it's being specified.

-p|--project PROJID
    Set project quota for PROJID.

--pool POOL_NAME
    Set quota per OST pool POOL_NAME.

-r  Reset the internal quota data of the user|group|project quota. It can be used to fix the quota containing corrupted internal data (such as, the quota grant).

-u|--userUSERNAME|UID
    Set user quota for UNAME or UID.

lfs setquota -t {-h|-u|-g|-p} GRACE_TIME
    Command sets the filesystem quota grace time for users, groups, or projects. The GRACE_TIME is a global value that can take two forms: an amount of time or the word notify. Traditionally, this indicates the amount of time in seconds that the soft quota limit can be exceeded before users are prevented from creating new files or consuming more space. This is intended to allow users to exceed the quota limit for a short time to complete their work without having to grant each user a larger hard quota limit. The alternative value of notify informs users with an '*' in the quota output that they are nearing their hard quota limit but does not block new writes until the hard quota limit is reached. The soft quota state is reset once the user, group, or project reduces their space usage or file count below the soft quota limit. Grace time is specified in "XXwXXdXXhXXmXXs" format or as an integer seconds value. The maximum is 2^48 - 1 seconds.

-t  Set quota grace times.

-u  Set grace time for user.

-g  Set grace time for group.

-p  Set grace time for project.

-b|--block-grace notify|BLOCK_GRACE_TIME
    Specify grace time for block quota.

-i|--inode-grace notify|INODE_GRACE_TIME
    Specify grace time for inode quota.

--pool POOL_NAME
    Set grace time for user, group or project per OST pool POOL_NAME.

lfs setquota {-U|--default-usr|-G|--default-grp|-P|--default-prj}
    Command sets the filesystem default limits for user, group, project quotas, if set, users/groups/projects without specific quota setting will use default quota limits automatically.

-U|--default-usr
    Set default user quota limit.

-G|--default-grp
    Set default group quota limit.

-P|--default-prj
    Set default project quota limit.

EXAMPLES

$ lfs setquota -u bob --block-softlimit 2G --block-hardlimit 1G /mnt/lustre
    Set quotas of user `bob': 1GB block hardlimit and 2 GB block softlimit

$ lfs setquota -u bob -D /mnt/lustre
    Set quotas of user `bob' to use default quota setting

$ lfs setquota -U --block-softlimit 1G --block-hardlimit 2G /mnt/lustre
    Set system default user quota: 1 GB block softlimit and 2 GB block hardlimit

$ lfs setquota -t -u --block-grace 1000 --inode-grace 1w4d /mnt/lustre
    Set grace times for user quotas: 1000 seconds for block quotas, 1 week and 4 days for inode quotas

$ lfs setquota -u ivan --pool flash_pool -B 1G /mnt/lustre
    Set hard block limit 1G for user 'ivan' per pool 'flash_pool'

$ lfs setquota -t -u --block-grace 1000 --pool flash_pool /mnt/lustre
    Set grace time 1000 seconds for block quotas per pool 'flash_pool'

lfs setquota {-u|-g|-p} UID|GID|PROJID [--delete] <filesystem>
    Command deletes the unused UID|GID|PROJID from Quota settings.

EXAMPLES

$ lfs setquota -u bob --delete /mnt/lustre
    Delete unused user 'bob'.

$ lfs setquota -u bob -r /mnt/lustre
    Reset the user 'bob'.

SEE ALSO
lfs(1), lfs-quota(1)