2 * Copyright (c) 2000-2008 Apple Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1982, 1986, 1993
31 * The Regents of the University of California. All rights reserved.
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions
36 * 1. Redistributions of source code must retain the above copyright
37 * notice, this list of conditions and the following disclaimer.
38 * 2. Redistributions in binary form must reproduce the above copyright
39 * notice, this list of conditions and the following disclaimer in the
40 * documentation and/or other materials provided with the distribution.
41 * 3. All advertising materials mentioning features or use of this software
42 * must display the following acknowledgement:
43 * This product includes software developed by the University of
44 * California, Berkeley and its contributors.
45 * 4. Neither the name of the University nor the names of its contributors
46 * may be used to endorse or promote products derived from this software
47 * without specific prior written permission.
49 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
50 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
61 * @(#)resource.h 8.2 (Berkeley) 1/4/94
64 #ifndef _SYS_RESOURCE_H_
65 #define _SYS_RESOURCE_H_
67 #include <sys/appleapiopts.h>
68 #include <sys/cdefs.h>
69 #include <sys/_types.h>
71 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
73 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
76 #include <Availability.h>
79 /* [XSI] The timeval structure shall be defined as described in
82 #include <sys/_types/_timeval.h>
84 #include <sys/_types/_user32_timeval.h>
85 #include <sys/_types/_user64_timeval.h>
88 /* The id_t type shall be defined as described in <sys/types.h> */
89 #include <sys/_types/_id_t.h>
93 * Resource limit type (low 63 bits, excluding the sign bit)
95 typedef __uint64_t rlim_t
;
103 * Possible values of the first parameter to getpriority()/setpriority(),
104 * used to indicate the type of the second parameter.
106 #define PRIO_PROCESS 0 /* Second argument is a PID */
107 #define PRIO_PGRP 1 /* Second argument is a GID */
108 #define PRIO_USER 2 /* Second argument is a UID */
110 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
111 #define PRIO_DARWIN_THREAD 3 /* Second argument is always 0 (current thread) */
112 #define PRIO_DARWIN_PROCESS 4 /* Second argument is a PID */
116 #define PRIO_DARWIN_GPU 5 /* Second argument is a PID */
118 #define PRIO_DARWIN_GPU_ALLOW 0x1
119 #define PRIO_DARWIN_GPU_DENY 0x2
121 #define PRIO_DARWIN_ROLE 6 /* Second argument is a PID */
123 #define PRIO_DARWIN_ROLE_DEFAULT 0x0 /* Reset to default state */
124 #define PRIO_DARWIN_ROLE_UI_FOCAL 0x1 /* On screen, focal UI */
125 #define PRIO_DARWIN_ROLE_UI 0x2 /* On screen UI, focal unknown */
126 #define PRIO_DARWIN_ROLE_NON_UI 0x3 /* Off screen, non-focal UI */
127 #define PRIO_DARWIN_ROLE_UI_NON_FOCAL 0x4 /* On screen, non-focal UI */
128 #define PRIO_DARWIN_ROLE_TAL_LAUNCH 0x5 /* Throttled-launch (for OS X TAL resume) */
133 * Range limitations for the value of the third parameter to setpriority().
139 * use PRIO_DARWIN_BG to set the current thread into "background" state
140 * which lowers CPU, disk IO, and networking priorites until thread terminates
141 * or "background" state is revoked
143 #define PRIO_DARWIN_BG 0x1000
146 * use PRIO_DARWIN_NONUI to restrict a process's ability to make calls to
147 * the GPU. (deprecated)
149 #define PRIO_DARWIN_NONUI 0x1001
151 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
160 * Possible values of the first parameter to getrusage(), used to indicate
161 * the scope of the information to be returned.
163 #define RUSAGE_SELF 0 /* Current process information */
164 #define RUSAGE_CHILDREN -1 /* Current process' children */
167 * A structure representing an accounting of resource utilization. The
168 * address of an instance of this structure is the second parameter to
171 * Note: All values other than ru_utime and ru_stime are implementaiton
172 * defined and subject to change in a future release. Their use
173 * is discouraged for standards compliant programs.
176 struct timeval ru_utime
; /* user time used (PL) */
177 struct timeval ru_stime
; /* system time used (PL) */
178 #if __DARWIN_C_LEVEL < __DARWIN_C_FULL
179 long ru_opaque
[14]; /* implementation defined */
182 * Informational aliases for source compatibility with programs
183 * that need more information than that provided by standards,
184 * and which do not mind being OS-dependent.
186 long ru_maxrss
; /* max resident set size (PL) */
187 #define ru_first ru_ixrss /* internal: ruadd() range start */
188 long ru_ixrss
; /* integral shared memory size (NU) */
189 long ru_idrss
; /* integral unshared data (NU) */
190 long ru_isrss
; /* integral unshared stack (NU) */
191 long ru_minflt
; /* page reclaims (NU) */
192 long ru_majflt
; /* page faults (NU) */
193 long ru_nswap
; /* swaps (NU) */
194 long ru_inblock
; /* block input operations (atomic) */
195 long ru_oublock
; /* block output operations (atomic) */
196 long ru_msgsnd
; /* messages sent (atomic) */
197 long ru_msgrcv
; /* messages received (atomic) */
198 long ru_nsignals
; /* signals received (atomic) */
199 long ru_nvcsw
; /* voluntary context switches (atomic) */
200 long ru_nivcsw
; /* involuntary " */
201 #define ru_last ru_nivcsw /* internal: ruadd() range end */
202 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
205 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
207 * Flavors for proc_pid_rusage().
209 #define RUSAGE_INFO_V0 0
210 #define RUSAGE_INFO_V1 1
211 #define RUSAGE_INFO_V2 2
212 #define RUSAGE_INFO_V3 3
213 #define RUSAGE_INFO_V4 4
214 #define RUSAGE_INFO_CURRENT RUSAGE_INFO_V4
216 typedef void *rusage_info_t
;
218 struct rusage_info_v0
{
220 uint64_t ri_user_time
;
221 uint64_t ri_system_time
;
222 uint64_t ri_pkg_idle_wkups
;
223 uint64_t ri_interrupt_wkups
;
225 uint64_t ri_wired_size
;
226 uint64_t ri_resident_size
;
227 uint64_t ri_phys_footprint
;
228 uint64_t ri_proc_start_abstime
;
229 uint64_t ri_proc_exit_abstime
;
232 struct rusage_info_v1
{
234 uint64_t ri_user_time
;
235 uint64_t ri_system_time
;
236 uint64_t ri_pkg_idle_wkups
;
237 uint64_t ri_interrupt_wkups
;
239 uint64_t ri_wired_size
;
240 uint64_t ri_resident_size
;
241 uint64_t ri_phys_footprint
;
242 uint64_t ri_proc_start_abstime
;
243 uint64_t ri_proc_exit_abstime
;
244 uint64_t ri_child_user_time
;
245 uint64_t ri_child_system_time
;
246 uint64_t ri_child_pkg_idle_wkups
;
247 uint64_t ri_child_interrupt_wkups
;
248 uint64_t ri_child_pageins
;
249 uint64_t ri_child_elapsed_abstime
;
252 struct rusage_info_v2
{
254 uint64_t ri_user_time
;
255 uint64_t ri_system_time
;
256 uint64_t ri_pkg_idle_wkups
;
257 uint64_t ri_interrupt_wkups
;
259 uint64_t ri_wired_size
;
260 uint64_t ri_resident_size
;
261 uint64_t ri_phys_footprint
;
262 uint64_t ri_proc_start_abstime
;
263 uint64_t ri_proc_exit_abstime
;
264 uint64_t ri_child_user_time
;
265 uint64_t ri_child_system_time
;
266 uint64_t ri_child_pkg_idle_wkups
;
267 uint64_t ri_child_interrupt_wkups
;
268 uint64_t ri_child_pageins
;
269 uint64_t ri_child_elapsed_abstime
;
270 uint64_t ri_diskio_bytesread
;
271 uint64_t ri_diskio_byteswritten
;
274 struct rusage_info_v3
{
276 uint64_t ri_user_time
;
277 uint64_t ri_system_time
;
278 uint64_t ri_pkg_idle_wkups
;
279 uint64_t ri_interrupt_wkups
;
281 uint64_t ri_wired_size
;
282 uint64_t ri_resident_size
;
283 uint64_t ri_phys_footprint
;
284 uint64_t ri_proc_start_abstime
;
285 uint64_t ri_proc_exit_abstime
;
286 uint64_t ri_child_user_time
;
287 uint64_t ri_child_system_time
;
288 uint64_t ri_child_pkg_idle_wkups
;
289 uint64_t ri_child_interrupt_wkups
;
290 uint64_t ri_child_pageins
;
291 uint64_t ri_child_elapsed_abstime
;
292 uint64_t ri_diskio_bytesread
;
293 uint64_t ri_diskio_byteswritten
;
294 uint64_t ri_cpu_time_qos_default
;
295 uint64_t ri_cpu_time_qos_maintenance
;
296 uint64_t ri_cpu_time_qos_background
;
297 uint64_t ri_cpu_time_qos_utility
;
298 uint64_t ri_cpu_time_qos_legacy
;
299 uint64_t ri_cpu_time_qos_user_initiated
;
300 uint64_t ri_cpu_time_qos_user_interactive
;
301 uint64_t ri_billed_system_time
;
302 uint64_t ri_serviced_system_time
;
305 struct rusage_info_v4
{
307 uint64_t ri_user_time
;
308 uint64_t ri_system_time
;
309 uint64_t ri_pkg_idle_wkups
;
310 uint64_t ri_interrupt_wkups
;
312 uint64_t ri_wired_size
;
313 uint64_t ri_resident_size
;
314 uint64_t ri_phys_footprint
;
315 uint64_t ri_proc_start_abstime
;
316 uint64_t ri_proc_exit_abstime
;
317 uint64_t ri_child_user_time
;
318 uint64_t ri_child_system_time
;
319 uint64_t ri_child_pkg_idle_wkups
;
320 uint64_t ri_child_interrupt_wkups
;
321 uint64_t ri_child_pageins
;
322 uint64_t ri_child_elapsed_abstime
;
323 uint64_t ri_diskio_bytesread
;
324 uint64_t ri_diskio_byteswritten
;
325 uint64_t ri_cpu_time_qos_default
;
326 uint64_t ri_cpu_time_qos_maintenance
;
327 uint64_t ri_cpu_time_qos_background
;
328 uint64_t ri_cpu_time_qos_utility
;
329 uint64_t ri_cpu_time_qos_legacy
;
330 uint64_t ri_cpu_time_qos_user_initiated
;
331 uint64_t ri_cpu_time_qos_user_interactive
;
332 uint64_t ri_billed_system_time
;
333 uint64_t ri_serviced_system_time
;
334 uint64_t ri_logical_writes
;
335 uint64_t ri_lifetime_max_phys_footprint
;
336 uint64_t ri_instructions
;
338 uint64_t ri_billed_energy
;
339 uint64_t ri_serviced_energy
;
340 // We're reserving 2 counters for future extension
341 uint64_t ri_unused
[2];
344 typedef struct rusage_info_v4 rusage_info_current
;
346 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
350 struct rusage_superset
{
352 rusage_info_current ri
;
355 struct rusage_info_child
{
356 uint64_t ri_child_user_time
;
357 uint64_t ri_child_system_time
;
358 uint64_t ri_child_pkg_idle_wkups
;
359 uint64_t ri_child_interrupt_wkups
;
360 uint64_t ri_child_pageins
;
361 uint64_t ri_child_elapsed_abstime
;
364 struct user64_rusage
{
365 struct user64_timeval ru_utime
; /* user time used */
366 struct user64_timeval ru_stime
; /* system time used */
367 user64_long_t ru_maxrss
; /* max resident set size */
368 user64_long_t ru_ixrss
; /* integral shared memory size */
369 user64_long_t ru_idrss
; /* integral unshared data " */
370 user64_long_t ru_isrss
; /* integral unshared stack " */
371 user64_long_t ru_minflt
; /* page reclaims */
372 user64_long_t ru_majflt
; /* page faults */
373 user64_long_t ru_nswap
; /* swaps */
374 user64_long_t ru_inblock
; /* block input operations */
375 user64_long_t ru_oublock
; /* block output operations */
376 user64_long_t ru_msgsnd
; /* messages sent */
377 user64_long_t ru_msgrcv
; /* messages received */
378 user64_long_t ru_nsignals
; /* signals received */
379 user64_long_t ru_nvcsw
; /* voluntary context switches */
380 user64_long_t ru_nivcsw
; /* involuntary " */
383 struct user32_rusage
{
384 struct user32_timeval ru_utime
; /* user time used */
385 struct user32_timeval ru_stime
; /* system time used */
386 user32_long_t ru_maxrss
; /* max resident set size */
387 user32_long_t ru_ixrss
; /* integral shared memory size */
388 user32_long_t ru_idrss
; /* integral unshared data " */
389 user32_long_t ru_isrss
; /* integral unshared stack " */
390 user32_long_t ru_minflt
; /* page reclaims */
391 user32_long_t ru_majflt
; /* page faults */
392 user32_long_t ru_nswap
; /* swaps */
393 user32_long_t ru_inblock
; /* block input operations */
394 user32_long_t ru_oublock
; /* block output operations */
395 user32_long_t ru_msgsnd
; /* messages sent */
396 user32_long_t ru_msgrcv
; /* messages received */
397 user32_long_t ru_nsignals
; /* signals received */
398 user32_long_t ru_nvcsw
; /* voluntary context switches */
399 user32_long_t ru_nivcsw
; /* involuntary " */
410 * Symbolic constants for resource limits; since all limits are representable
411 * as a type rlim_t, we are permitted to define RLIM_SAVED_* in terms of
414 #define RLIM_INFINITY (((__uint64_t)1 << 63) - 1) /* no limit */
415 #define RLIM_SAVED_MAX RLIM_INFINITY /* Unrepresentable hard limit */
416 #define RLIM_SAVED_CUR RLIM_INFINITY /* Unrepresentable soft limit */
419 * Possible values of the first parameter to getrlimit()/setrlimit(), to
420 * indicate for which resource the operation is being performed.
422 #define RLIMIT_CPU 0 /* cpu time per process */
423 #define RLIMIT_FSIZE 1 /* file size */
424 #define RLIMIT_DATA 2 /* data segment size */
425 #define RLIMIT_STACK 3 /* stack size */
426 #define RLIMIT_CORE 4 /* core file size */
427 #define RLIMIT_AS 5 /* address space (resident set size) */
428 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
429 #define RLIMIT_RSS RLIMIT_AS /* source compatibility alias */
430 #define RLIMIT_MEMLOCK 6 /* locked-in-memory address space */
431 #define RLIMIT_NPROC 7 /* number of processes */
432 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
433 #define RLIMIT_NOFILE 8 /* number of open files */
434 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
435 #define RLIM_NLIMITS 9 /* total number of resource limits */
436 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
437 #define _RLIMIT_POSIX_FLAG 0x1000 /* Set bit for strict POSIX */
440 * A structure representing a resource limit. The address of an instance
441 * of this structure is the second parameter to getrlimit()/setrlimit().
444 rlim_t rlim_cur
; /* current (soft) limit */
445 rlim_t rlim_max
; /* maximum value for rlim_cur */
448 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
450 * proc_rlimit_control()
452 * Resource limit flavors
454 #define RLIMIT_WAKEUPS_MONITOR 0x1 /* Configure the wakeups monitor. */
455 #define RLIMIT_CPU_USAGE_MONITOR 0x2 /* Configure the CPU usage monitor. */
456 #define RLIMIT_THREAD_CPULIMITS 0x3 /* Configure a blocking, per-thread, CPU limits. */
459 * Flags for wakeups monitor control.
461 #define WAKEMON_ENABLE 0x01
462 #define WAKEMON_DISABLE 0x02
463 #define WAKEMON_GET_PARAMS 0x04
464 #define WAKEMON_SET_DEFAULTS 0x08
465 #define WAKEMON_MAKE_FATAL 0x10 /* Configure the task so that violations are fatal. */
467 * Flags for CPU usage monitor control.
469 #define CPUMON_MAKE_FATAL 0x1000
471 struct proc_rlimit_control_wakeupmon
{
478 * Flags for I/O monitor control.
480 #define IOMON_ENABLE 0x01
481 #define IOMON_DISABLE 0x02
487 #define IOPOL_TYPE_DISK 0
489 #define IOPOL_TYPE_VFS_HFS_CASE_SENSITIVITY 1
493 #define IOPOL_SCOPE_PROCESS 0
494 #define IOPOL_SCOPE_THREAD 1
495 #define IOPOL_SCOPE_DARWIN_BG 2
498 #define IOPOL_DEFAULT 0
499 #define IOPOL_IMPORTANT 1
500 #define IOPOL_PASSIVE 2
501 #define IOPOL_THROTTLE 3
502 #define IOPOL_UTILITY 4
503 #define IOPOL_STANDARD 5
505 /* compatibility with older names */
506 #define IOPOL_APPLICATION IOPOL_STANDARD
507 #define IOPOL_NORMAL IOPOL_IMPORTANT
510 #define IOPOL_VFS_HFS_CASE_SENSITIVITY_DEFAULT 0
511 #define IOPOL_VFS_HFS_CASE_SENSITIVITY_FORCE_CASE_SENSITIVE 1
516 * Structures for use in communicating via iopolicysys() between Libc and the
517 * kernel. Not to be used by user programs directly.
521 * the command to iopolicysys()
523 #define IOPOL_CMD_GET 0x00000001 /* Get I/O policy */
524 #define IOPOL_CMD_SET 0x00000002 /* Set I/O policy */
527 * Second parameter to iopolicysys()
529 struct _iopol_param_t
{
530 int iop_scope
; /* current process or a thread */
536 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
541 int getpriority(int, id_t
);
542 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
543 int getiopolicy_np(int, int) __OSX_AVAILABLE_STARTING(__MAC_10_5
, __IPHONE_2_0
);
544 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
545 int getrlimit(int, struct rlimit
*) __DARWIN_ALIAS(getrlimit
);
546 int getrusage(int, struct rusage
*);
547 int setpriority(int, id_t
, int);
548 #if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
549 int setiopolicy_np(int, int, int) __OSX_AVAILABLE_STARTING(__MAC_10_5
, __IPHONE_2_0
);
550 #endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
551 int setrlimit(int, const struct rlimit
*) __DARWIN_ALIAS(setrlimit
);
555 #endif /* !_SYS_RESOURCE_H_ */