Version information
This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
- Puppet >= 4.10.0 < 7.0.0
Start using this module
Add this module to your Puppetfile:
mod 'aursu-rlimits', '0.1.0'
Learn more about managing modules with a PuppetfileDocumentation
rlimits
Control configuration files for the pam_limits module (see man 5 limits.conf)
Table of Contents
- Description
- Setup - The basics of getting started with rlimits
- Usage - Configuration options and additional functionality
- Reference
Description
The pam_limits.so
module applies ulimit
limits, nice priority and number of
simultaneous login sessions limit to user login sessions. This description of
the configuration file syntax applies to the /etc/security/limits.conf
file
and *.conf
files in the /etc/security/limits.d
directory.
The syntax of the lines is as follows:
<domain><type><item><value>
Setup
What rlimits affects OPTIONAL
rlimits affects only *.conf
files in the /etc/security/limits.d
Beginning with rlimits
To use this module it is enough to include it into catalog
include rlimits
Usage
rlimit { '*/nproc/soft':
ensure => present,
value => 4096,
}
rlimit { 'root/nproc/soft':
ensure => present,
}
Reference
See REFERENCE.md for reference
Reference
Table of Contents
Classes
rlimits
: Control resource limits environment
Resource types
rlimit
: Manage resource limit record
Classes
rlimits
Control resource limits environment
Examples
include rlimits
Parameters
The following parameters are available in the rlimits
class.
manage_folder
Data type: Boolean
Whether to control or not folder /etc/security/limits.d
Default value: true
purge_folder
Data type: Boolean
Set flag purge on /etc/security/limits.d file resource to cleanup unmanaged files
Default value: false
vendor_settings
Data type: Boolean
Setup or not vendors default preset of ulimits (valid for CentOS)
Default value: true
Resource types
rlimit
Manage resource limit record
Properties
The following properties are available in the rlimit
type.
ensure
Valid values: present
, absent
The basic property that the resource should be in.
Default value: present
Parameters
The following parameters are available in the rlimit
type.
domain
namevar
According to man 5 limits.conf next values are possible:
- username
- @groupname
- % (maxlogins only) -> maxsyslogins
- %group (maxlogins only)
- <min_uid>:<max_uid>
- <min_uid>:
- :<max_uid>
- @<min_gid>:<max_gid>
- @<min_gid>:
- @:<max_gid>
- %:gid
item
Valid values: core
, data
, fsize
, memlock
, nofile
, rss
, stack
, cpu
, nproc
, as
, maxlogins
, maxsyslogins
, priority
, locks
, sigpending
, msgqueue
, nice
, rtprio
namevar
item name (see man 5 limits.conf)
name
The resource limit name
provider
The specific backend to use for this rlimit
resource. You will seldom need to specify this --- Puppet will usually
discover the appropriate provider for your platform.
type
Valid values: soft
, hard
, any
namevar
resource limits type (see man 5 limits.conf)
Default value: any
value
Valid values: unlimited
, %r{^-?\d+$}
, infinity
Aliases: "infinity"=>"unlimited"
The resource value
Default value: unlimited