userquota create

Prev Next

This command creates a user or group quota rule for a specific directory quota.

Usage
userquota create --identifier-type username|groupname|uid|gid
                 --identifier IDENTIFIER
                 --quota-id QUOTA_ID
                 --user|--group
                 [--grace-period]
                 [--soft-limit]
                 [--hard-limit]
                 [--hard-limit-inodes]
                 [--soft-limit-inodes]
Required Parameters

--identifier-type username|groupname|uid|gid

Specify how you want to identify the user or group for which a quota is create:

  • username. By the name of the user.

  • groupname. By the name of the group.

  • uid, By the user's UID.

  • gid. By the group's GID.

--identifier IDENTIFIER

Specify the identifier of the user or group for which the quota is created. The identifier must be of the type set with --identifier-type.

--quota-id QUOTA_ID

Identifies the directory quota under which the user or group quota is created.

--user|--group

Specify --user to configure a user quota rule or --group to configure a group quota.  

Options

--grace-period

Sets a grace period. If the specified user's or group's capacity usage continues to exceed the soft limit for the period of time set as the grace period, the user or group is blocked from writing to the directory. 

Specify GRACE_PERIOD in the format: [DD] [HH:[MM:]]ss or as an integer followed by d for days, h for hours, m for minutes, or s for seconds. Examples:

  • To specify 30 days, 20 hours, 15 minutes and 10 seconds: --grace-period 30 20:15:10.

  • To specify 18 hours: --grace-period 18:00.

  • To specify 7 days: --grace-period 7d

--soft-limit

Sets a capacity usage soft limit for the specified user/group.

--hard-limit

Sets a storage usage limit. No writes are allowed for the specified user/group beyond this limit.

The value must be a complete integer and must be specified with a unit of measurement. Do not insert a space between the value and the unit of measurements. Valid units are:

  • Base 10: KB, MB, GB, TB, PB, EB,

  • Base 2: KiB, MiB, GiB, TiB, PiB, EiB

--hard-limit-inodes

Sets a limit on the number of directories and unique files the specified user/group can create under the path. A file with multiple hardlinks is counted only once.

--soft-limit-inodes

Sets a soft limit on the number of directories and unique files under the path. Warnings of exceeding the quota are issued when the limit is reached. A file with multiple hardlinks is counted only once.