Import Linux-PAM.
[profile/ivi/pam.git] / modules / pam_limits / README
1 pam_limits — PAM module to limit resources
2
3 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4
5 DESCRIPTION
6
7 The pam_limits PAM module sets limits on the system resources that can be
8 obtained in a user-session. Users of uid=0 are affected by this limits, too.
9
10 By default limits are taken from the /etc/security/limits.conf config file.
11 Then individual *.conf files from the /etc/security/limits.d/ directory are
12 read. The files are parsed one after another in the order of "C" locale. The
13 effect of the individual files is the same as if all the files were
14 concatenated together in the order of parsing. If a config file is explicitly
15 specified with a module option then the files in the above directory are not
16 parsed.
17
18 The module must not be called by a multithreaded application.
19
20 If Linux PAM is compiled with audit support the module will report when it
21 denies access based on limit of maximum number of concurrent login sessions.
22
23 OPTIONS
24
25 conf=/path/to/limits.conf
26
27     Indicate an alternative limits.conf style configuration file to override
28     the default.
29
30 debug
31
32     Print debug information.
33
34 set_all
35
36     Set the limits for which no value is specified in the configuration file to
37     the one from the process with the PID 1.
38
39 utmp_early
40
41     Some broken applications actually allocate a utmp entry for the user before
42     the user is admitted to the system. If some of the services you are
43     configuring PAM for do this, you can selectively use this module argument
44     to compensate for this behavior and at the same time maintain system-wide
45     consistency with a single limits.conf file.
46
47 noaudit
48
49     Do not report exceeded maximum logins count to the audit subsystem.
50
51 EXAMPLES
52
53 These are some example lines which might be specified in /etc/security/
54 limits.conf.
55
56 *               soft    core            0
57 *               hard    nofile          512
58 @student        hard    nproc           20
59 @faculty        soft    nproc           20
60 @faculty        hard    nproc           50
61 ftp             hard    nproc           0
62 @student        -       maxlogins       4
63 :123            hard    cpu             5000
64 @500:           soft    cpu             10000
65 600:700         hard    locks           10
66
67