xfs_quota – Manage quotas on XFS filesystems
New in version 2.8.
Synopsis
- Configure quotas on XFS filesystems.
- Before using this module /etc/projects and /etc/projid need to be configured.
Requirements
The below requirements are needed on the host that executes this module.
- xfsprogs
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
bhard
string
|
Hard blocks quota limit.
This argument supports human readable sizes.
|
|
bsoft
string
|
Soft blocks quota limit.
This argument supports human readable sizes.
|
|
ihard
integer
|
Hard inodes quota limit.
|
|
isoft
integer
|
Soft inodes quota limit.
|
|
mountpoint
string /
required
|
The mount point on which to apply the quotas.
|
|
name
string
|
The name of the user, group or project to apply the quota to, if other than default.
|
|
rtbhard
string
|
Hard realtime blocks quota limit.
This argument supports human readable sizes.
|
|
rtbsoft
string
|
Soft realtime blocks quota limit.
This argument supports human readable sizes.
|
|
state
string
|
|
Whether to apply the limits or remove them.
When removing limit, they are set to 0, and not quite removed.
|
type
string /
required
|
|
The XFS quota type.
|
Examples
- name: Set default project soft and hard limit on /opt of 1g xfs_quota: type: project mountpoint: /opt bsoft: 1g bhard: 1g state: present - name: Remove the default limits on /opt xfs_quota: type: project mountpoint: /opt state: absent - name: Set default soft user inode limits on /home of 1024 inodes and hard of 2048 xfs_quota: type: user mountpoint: /home isoft: 1024 ihard: 2048
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
bhard
integer
|
always |
the current bhard setting in bytes
Sample:
1024
|
bsoft
integer
|
always |
the current bsoft setting in bytes
Sample:
1024
|
ihard
integer
|
always |
the current ihard setting in bytes
Sample:
100
|
isoft
integer
|
always |
the current isoft setting in bytes
Sample:
100
|
rtbhard
integer
|
always |
the current rtbhard setting in bytes
Sample:
1024
|
rtbsoft
integer
|
always |
the current rtbsoft setting in bytes
Sample:
1024
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- William Leemans (@bushvin)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/xfs_quota_module.html