1/* Bit values & structures for resource limits. Linux version.
2 Copyright (C) 1994-2016 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
9
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <http://www.gnu.org/licenses/>. */
18
19#ifndef _SYS_RESOURCE_H
20# error "Never use <bits/resource.h> directly; include <sys/resource.h> instead."
21#endif
22
23#include <bits/types.h>
24
25/* Transmute defines to enumerations. The macro re-definitions are
26 necessary because some programs want to test for operating system
27 features with #ifdef RUSAGE_SELF. In ISO C the reflexive
28 definition is a no-op. */
29
30/* Kinds of resource limit. */
31enum __rlimit_resource
32{
33 /* Per-process CPU limit, in seconds. */
34 RLIMIT_CPU = 0,
35#define RLIMIT_CPU RLIMIT_CPU
36
37 /* Largest file that can be created, in bytes. */
38 RLIMIT_FSIZE = 1,
39#define RLIMIT_FSIZE RLIMIT_FSIZE
40
41 /* Maximum size of data segment, in bytes. */
42 RLIMIT_DATA = 2,
43#define RLIMIT_DATA RLIMIT_DATA
44
45 /* Maximum size of stack segment, in bytes. */
46 RLIMIT_STACK = 3,
47#define RLIMIT_STACK RLIMIT_STACK
48
49 /* Largest core file that can be created, in bytes. */
50 RLIMIT_CORE = 4,
51#define RLIMIT_CORE RLIMIT_CORE
52
53 /* Largest resident set size, in bytes.
54 This affects swapping; processes that are exceeding their
55 resident set size will be more likely to have physical memory
56 taken from them. */
57 __RLIMIT_RSS = 5,
58#define RLIMIT_RSS __RLIMIT_RSS
59
60 /* Number of open files. */
61 RLIMIT_NOFILE = 7,
62 __RLIMIT_OFILE = RLIMIT_NOFILE, /* BSD name for same. */
63#define RLIMIT_NOFILE RLIMIT_NOFILE
64#define RLIMIT_OFILE __RLIMIT_OFILE
65
66 /* Address space limit. */
67 RLIMIT_AS = 9,
68#define RLIMIT_AS RLIMIT_AS
69
70 /* Number of processes. */
71 __RLIMIT_NPROC = 6,
72#define RLIMIT_NPROC __RLIMIT_NPROC
73
74 /* Locked-in-memory address space. */
75 __RLIMIT_MEMLOCK = 8,
76#define RLIMIT_MEMLOCK __RLIMIT_MEMLOCK
77
78 /* Maximum number of file locks. */
79 __RLIMIT_LOCKS = 10,
80#define RLIMIT_LOCKS __RLIMIT_LOCKS
81
82 /* Maximum number of pending signals. */
83 __RLIMIT_SIGPENDING = 11,
84#define RLIMIT_SIGPENDING __RLIMIT_SIGPENDING
85
86 /* Maximum bytes in POSIX message queues. */
87 __RLIMIT_MSGQUEUE = 12,
88#define RLIMIT_MSGQUEUE __RLIMIT_MSGQUEUE
89
90 /* Maximum nice priority allowed to raise to.
91 Nice levels 19 .. -20 correspond to 0 .. 39
92 values of this resource limit. */
93 __RLIMIT_NICE = 13,
94#define RLIMIT_NICE __RLIMIT_NICE
95
96 /* Maximum realtime priority allowed for non-priviledged
97 processes. */
98 __RLIMIT_RTPRIO = 14,
99#define RLIMIT_RTPRIO __RLIMIT_RTPRIO
100
101 /* Maximum CPU time in µs that a process scheduled under a real-time
102 scheduling policy may consume without making a blocking system
103 call before being forcibly descheduled. */
104 __RLIMIT_RTTIME = 15,
105#define RLIMIT_RTTIME __RLIMIT_RTTIME
106
107 __RLIMIT_NLIMITS = 16,
108 __RLIM_NLIMITS = __RLIMIT_NLIMITS
109#define RLIMIT_NLIMITS __RLIMIT_NLIMITS
110#define RLIM_NLIMITS __RLIM_NLIMITS
111};
112
113/* Value to indicate that there is no limit. */
114#ifndef __USE_FILE_OFFSET64
115# define RLIM_INFINITY ((__rlim_t) -1)
116#else
117# define RLIM_INFINITY 0xffffffffffffffffuLL
118#endif
119
120#ifdef __USE_LARGEFILE64
121# define RLIM64_INFINITY 0xffffffffffffffffuLL
122#endif
123
124/* We can represent all limits. */
125#define RLIM_SAVED_MAX RLIM_INFINITY
126#define RLIM_SAVED_CUR RLIM_INFINITY
127
128
129/* Type for resource quantity measurement. */
130#ifndef __USE_FILE_OFFSET64
131typedef __rlim_t rlim_t;
132#else
133typedef __rlim64_t rlim_t;
134#endif
135#ifdef __USE_LARGEFILE64
136typedef __rlim64_t rlim64_t;
137#endif
138
139struct rlimit
140 {
141 /* The current (soft) limit. */
142 rlim_t rlim_cur;
143 /* The hard limit. */
144 rlim_t rlim_max;
145 };
146
147#ifdef __USE_LARGEFILE64
148struct rlimit64
149 {
150 /* The current (soft) limit. */
151 rlim64_t rlim_cur;
152 /* The hard limit. */
153 rlim64_t rlim_max;
154 };
155#endif
156
157/* Whose usage statistics do you want? */
158enum __rusage_who
159{
160 /* The calling process. */
161 RUSAGE_SELF = 0,
162#define RUSAGE_SELF RUSAGE_SELF
163
164 /* All of its terminated child processes. */
165 RUSAGE_CHILDREN = -1
166#define RUSAGE_CHILDREN RUSAGE_CHILDREN
167
168#ifdef __USE_GNU
169 ,
170 /* The calling thread. */
171 RUSAGE_THREAD = 1
172# define RUSAGE_THREAD RUSAGE_THREAD
173 /* Name for the same functionality on Solaris. */
174# define RUSAGE_LWP RUSAGE_THREAD
175#endif
176};
177
178#define __need_timeval
179#include <bits/time.h> /* For `struct timeval'. */
180
181/* Structure which says how much of each resource has been used. */
182
183/* The purpose of all the unions is to have the kernel-compatible layout
184 while keeping the API type as 'long int', and among machines where
185 __syscall_slong_t is not 'long int', this only does the right thing
186 for little-endian ones, like x32. */
187struct rusage
188 {
189 /* Total amount of user time used. */
190 struct timeval ru_utime;
191 /* Total amount of system time used. */
192 struct timeval ru_stime;
193 /* Maximum resident set size (in kilobytes). */
194 __extension__ union
195 {
196 long int ru_maxrss;
197 __syscall_slong_t __ru_maxrss_word;
198 };
199 /* Amount of sharing of text segment memory
200 with other processes (kilobyte-seconds). */
201 /* Maximum resident set size (in kilobytes). */
202 __extension__ union
203 {
204 long int ru_ixrss;
205 __syscall_slong_t __ru_ixrss_word;
206 };
207 /* Amount of data segment memory used (kilobyte-seconds). */
208 __extension__ union
209 {
210 long int ru_idrss;
211 __syscall_slong_t __ru_idrss_word;
212 };
213 /* Amount of stack memory used (kilobyte-seconds). */
214 __extension__ union
215 {
216 long int ru_isrss;
217 __syscall_slong_t __ru_isrss_word;
218 };
219 /* Number of soft page faults (i.e. those serviced by reclaiming
220 a page from the list of pages awaiting reallocation. */
221 __extension__ union
222 {
223 long int ru_minflt;
224 __syscall_slong_t __ru_minflt_word;
225 };
226 /* Number of hard page faults (i.e. those that required I/O). */
227 __extension__ union
228 {
229 long int ru_majflt;
230 __syscall_slong_t __ru_majflt_word;
231 };
232 /* Number of times a process was swapped out of physical memory. */
233 __extension__ union
234 {
235 long int ru_nswap;
236 __syscall_slong_t __ru_nswap_word;
237 };
238 /* Number of input operations via the file system. Note: This
239 and `ru_oublock' do not include operations with the cache. */
240 __extension__ union
241 {
242 long int ru_inblock;
243 __syscall_slong_t __ru_inblock_word;
244 };
245 /* Number of output operations via the file system. */
246 __extension__ union
247 {
248 long int ru_oublock;
249 __syscall_slong_t __ru_oublock_word;
250 };
251 /* Number of IPC messages sent. */
252 __extension__ union
253 {
254 long int ru_msgsnd;
255 __syscall_slong_t __ru_msgsnd_word;
256 };
257 /* Number of IPC messages received. */
258 __extension__ union
259 {
260 long int ru_msgrcv;
261 __syscall_slong_t __ru_msgrcv_word;
262 };
263 /* Number of signals delivered. */
264 __extension__ union
265 {
266 long int ru_nsignals;
267 __syscall_slong_t __ru_nsignals_word;
268 };
269 /* Number of voluntary context switches, i.e. because the process
270 gave up the process before it had to (usually to wait for some
271 resource to be available). */
272 __extension__ union
273 {
274 long int ru_nvcsw;
275 __syscall_slong_t __ru_nvcsw_word;
276 };
277 /* Number of involuntary context switches, i.e. a higher priority process
278 became runnable or the current process used up its time slice. */
279 __extension__ union
280 {
281 long int ru_nivcsw;
282 __syscall_slong_t __ru_nivcsw_word;
283 };
284 };
285
286/* Priority limits. */
287#define PRIO_MIN -20 /* Minimum priority a process can have. */
288#define PRIO_MAX 20 /* Maximum priority a process can have. */
289
290/* The type of the WHICH argument to `getpriority' and `setpriority',
291 indicating what flavor of entity the WHO argument specifies. */
292enum __priority_which
293{
294 PRIO_PROCESS = 0, /* WHO is a process ID. */
295#define PRIO_PROCESS PRIO_PROCESS
296 PRIO_PGRP = 1, /* WHO is a process group ID. */
297#define PRIO_PGRP PRIO_PGRP
298 PRIO_USER = 2 /* WHO is a user ID. */
299#define PRIO_USER PRIO_USER
300};
301
302
303__BEGIN_DECLS
304
305#ifdef __USE_GNU
306/* Modify and return resource limits of a process atomically. */
307# ifndef __USE_FILE_OFFSET64
308extern int prlimit (__pid_t __pid, enum __rlimit_resource __resource,
309 const struct rlimit *__new_limit,
310 struct rlimit *__old_limit) __THROW;
311# else
312# ifdef __REDIRECT_NTH
313extern int __REDIRECT_NTH (prlimit, (__pid_t __pid,
314 enum __rlimit_resource __resource,
315 const struct rlimit *__new_limit,
316 struct rlimit *__old_limit), prlimit64);
317# else
318# define prlimit prlimit64
319# endif
320# endif
321# ifdef __USE_LARGEFILE64
322extern int prlimit64 (__pid_t __pid, enum __rlimit_resource __resource,
323 const struct rlimit64 *__new_limit,
324 struct rlimit64 *__old_limit) __THROW;
325# endif
326#endif
327
328__END_DECLS
329