userquota create

Prev Next

This command creates a user quota or a group quota for a directory on which a directory quota is set.

Usage

userquota create --identifier-type username|groupname|uid|gid
                 --identifier IDENTIFIER
                 --quota-id ID
                 --quota-group-id ID
                 --user|--group
                 [--soft-limit LIMIT]
                 [--soft-limit-inodes LIMIT]
                 [--grace-period PERIOD]
                 [--hard-limit LIMIT]       
                 [--hard-limit-inodes LIMIT]

Required Parameters

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

Determines how you want to identify the user or group for which a quota is created:

  • 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 ID

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

--quota-group-id ID

Identifies the quota group associated with the user/group quota.

--user|--group

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

Options to Set User/Group Quota Limits

--soft-limit LIMIT

The soft limit of capacity usage for the user or group.

When this limit is reached, a notification email is sent, and the grace period countdown commences. Writes are blocked only after the grace period expires.

Specify LIMIT as a number followed by units of measure, for example: --soft-limit 1gb

If not specified, no soft limit is applied.

--soft-limit-inodes LIMIT

The soft limit on the number of directories and unique files that the user or group can create in the quota directory.

When this limit is reached, a notification email is sent, and the grace period countdown commences. Writes are blocked only after the grace period expires.

NOTE: A file with multiple hardlinks is counted only once.

--grace-period PERIOD

A period during which writes to the quota directory are not blocked although the user or group has exceeded a soft limit. 

If the grace period is not set, exceeding a soft limit does not cause blocking of further writes to the quota directory. 

Specify PERIOD as follows:

  • As the number of time units followed by a time unit letter, for example: 10d, 10h, 10m, 10s.

  • The value is case-sensitive, entering 10D or 10H will return an error.

  • In the format [DD] [HH:[MM:]]ss. For example:

    • 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

--hard-limit LIMIT

The limit of capacity usage above which no further writes are allowed for the user or group.

When the hard limit is reached, the HARD_EXCEEDED alarm is raised.

Specify LIMIT as an integer followed by a unit of measure (without a space in between). Valid units are:

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

  • Base2: KiB, MiB, GiB, TiB, PiB, EiB

The units are case-insensitive. For example, 4gb is valid. 

If not specified, no hard limit is applied.

--hard-limit-inodes LIMIT

The limit on the number of directories and unique files that the user or group can create in the quota directory, above which no further writes are allowed.

Note

NOTE: A file with multiple hardlinks is counted only once.

Specify LIMIT as an integer.