prlimit(1)

1
2PRLIMIT(1)                       User Commands                      PRLIMIT(1)
3
4
5

NAME

7       prlimit - get and set a process resource limits.
8

SYNOPSIS

10       prlimit [options] [--{resource_name}[=limits] [--pid PID]
11
12       prlimit [options] [--{resource_name}[=limits]] command [argument...]
13
14

DESCRIPTION

16       Given a process id and one or more resources, prlimit tries to retrieve
17       and/or modify the limits.
18
19       When command is given, prlimit will run this  command  with  the  given
20       arguments.
21
22       The  limits  format  is  composed by a soft and a hard (ceiling) value,
23       separated by a semicolon (:), in order to modify the existing value(s).
24       If no limits are used, prlimit will only display the current values. If
25       one of the values is not used, then the existing one will be  used.  To
26       specify  the  unlimited  or  infinity  limit (RLIM_INFINITY), the -1 or
27       'unlimited' string can be passed.
28
29       Because of the nature of limits, the soft value must be lower or  equal
30       to  the  high limit. To see all the available resource limits, refer to
31       the RESOURCE OPTIONS section.
32
33
34       <soft>:<hard>  Specify both limits
35
36       <soft>:        Specify only the soft limit
37
38       :<hard>        Specify only the hard limit
39
40       <value>        Specify both soft and hard limits to the same value
41
42

GENERAL OPTIONS

44       -p, --pid
45              Specify the process id, if none is given, it will use  the  run‐
46              ning process.
47
48       -o, --output list
49              Define  the  output  columns to use. If no output arrangement is
50              specified, then a default set is used.  Use --help to  get  list
51              of all supported columns.
52
53       -V, --version
54              Output version information and exit.
55
56       --verbose
57              Verbose mode.
58
59       --raw  Use the raw output format.
60
61       --noheadings
62              Do not print a header line.
63
64       -h, --help
65              Print a help text and exit.
66
67

RESOURCE OPTIONS

69       -c, --core[=limits]
70              Maximum size of a core file.
71
72       -d, --data[=limits]
73              Maximum data size.
74
75       -e, --nice[=limits]
76              Maximum nice priority allowed to raise.
77
78       -f, --fsize[=limits]
79              Maximum file size.
80
81       -i, --sigpending[=limits]
82              Maximum number of pending signals.
83
84       -l, --memlock[=limits]
85              Maximum locked-in-memory address space.
86
87       -m, --rss[=limits]
88              Maximum Resident Set Size (RSS).
89
90       -n, --nofile[=limits]
91              Maximum number of open files.
92
93       -q, --msgqueue[=limits]
94              Maximum number of bytes in POSIX message queues.
95
96       -r, --rtprio[=limits]
97              Maximum real-time priority.
98
99       -s, --stack[=limits]
100              Maximum size of the stack.
101
102       -t, --cpu[=limits]
103              CPU time, in seconds.
104
105       -u, --nproc[=limits]
106              Maximum number of processes.
107
108       -v, --as[=limits]
109              Address space limit.
110
111       -x, --locks[=limits]
112              Maximum number of file locks held.
113
114       -y, --rttime[=limits]
115              Timeout for real-time tasks.
116
117

EXAMPLES

119       prlimit --pid 13134
120              Display limit values for all current resources.
121
122       prlimit --pid 13134 --rss --nofile=1024:4095
123              Display  the  limits of the RSS and set the soft and hard limits
124              for the number of open files to 1024 and 4095, respectively.
125
126       prlimit --pid 13134 --nproc=512:
127              Modify only the soft limit for the number of processes.
128
129       prlimit --pid $$ --nproc=unlimited
130              Set the number of processes for both soft and ceiling values  to
131              unlimited.
132
133       prlimit --cpu=10 sort -u hugefile
134              Set the soft and hard CPU time limit and run 'sort'.
135
136

NOTES

142       The prlimit system call is supported since Linux 2.6.36, previous kernels will
143       break this program.
144
145

AUTHORS

147       Davidlohr Bueso <dave@gnu.org> - In memory of Dennis M. Ritchie.
148

AVAILABILITY

150       The  prlimit command is part of the util-linux package and is available
151       from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
152
153
154
155util-linux                       October 2011                       PRLIMIT(1)