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