]> git.saurik.com Git - apple/xnu.git/blame - libsyscall/wrappers/libproc/libproc_internal.h
xnu-2782.40.9.tar.gz
[apple/xnu.git] / libsyscall / wrappers / libproc / libproc_internal.h
CommitLineData
39236c6e
A
1/*
2 * Copyright (c) 2010 Apple Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
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. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23#ifndef _LIBPROC_INTERNALH_
24#define _LIBPROC_INTERNALH_
25
26#include <TargetConditionals.h>
27
28#include <sys/cdefs.h>
29#include <libproc.h>
30
31__BEGIN_DECLS
32
39236c6e
A
33
34/* resume the process suspend due to low VM resource */
35int proc_clear_vmpressure(pid_t pid);
36/* set self as the one who is going to resume suspended processes due to low VM. Need to be root */
37int proc_set_owner_vmpressure(void);
38
39/* mark yourself to delay idle sleep on disk IO */
40int proc_set_delayidlesleep(void);
41/* Reset yourself to delay idle sleep on disk IO, if already set */
42int proc_clear_delayidlesleep(void);
43
44
45/* sub policies for PROC_POLICY_APPTYPE */
46#define PROC_POLICY_OSX_APPTYPE_NONE 0
47#define PROC_POLICY_OSX_APPTYPE_TAL 1 /* TAL based launched */
48#define PROC_POLICY_OSX_APPTYPE_WIDGET 2 /* for dashboard client */
49#define PROC_POLICY_OSX_APPTYPE_DASHCLIENT 2 /* rename to move away from widget */
50
51/*
52 * Resumes the backgrounded TAL or dashboard client. Only priv users can disable TAL apps.
53 * Valid apptype are PROC_POLICY_OSX_APPTYPE_DASHCLIENT and PROC_POLICY_OSX_APPTYPE_TAL.
54 * Returns 0 on success otherwise appropriate error code.
55 */
56int proc_disable_apptype(pid_t pid, int apptype);
57int proc_enable_apptype(pid_t pid, int apptype);
58
39236c6e
A
59
60/* mark process as importance donating */
61int proc_donate_importance_boost(void);
62
fe8ab488 63/* DEPRECATED: supported for backward compatibility only */
39236c6e
A
64/* check the message for an importance boost and take an assertion on it */
65int proc_importance_assertion_begin_with_msg(mach_msg_header_t *msg,
fe8ab488
A
66 mach_msg_trailer_t *trailer,
67 uint64_t *assertion_token) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_8, __MAC_10_10, __IPHONE_6_0, __IPHONE_8_0);
39236c6e 68
fe8ab488 69/* DEPRECATED: supported for backward compatibility only */
39236c6e
A
70/* drop an assertion */
71int proc_importance_assertion_complete(uint64_t assertion_handle);
72
fe8ab488
A
73/* check the message for a App De-Nap boost and take an assertion on it */
74int proc_denap_assertion_begin_with_msg(mach_msg_header_t *msg,
75 uint64_t *assertion_token);
76
77/* drop a de-nap assertion */
78int proc_denap_assertion_complete(uint64_t assertion_handle);
79
39236c6e
A
80int proc_set_cpumon_params(pid_t pid, int percentage, int interval) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
81int proc_get_cpumon_params(pid_t pid, int *percentage, int *interval) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
82int proc_set_cpumon_defaults(pid_t pid) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
83int proc_disable_cpumon(pid_t pid) __OSX_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_6_0);
84
85int proc_set_wakemon_params(pid_t pid, int rate_hz, int flags) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
86int proc_get_wakemon_params(pid_t pid, int *rate_hz, int *flags) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
87int proc_set_wakemon_defaults(pid_t pid) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
88int proc_disable_wakemon(pid_t pid) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
89
fe8ab488
A
90int proc_set_cpumon_params_fatal(pid_t pid, int percentage, int interval) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
91
92/* request trace buffer collection */
93int proc_trace_log(pid_t pid, uint64_t uniqueid) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
94
95/* proc_info call to get the originator information */
96int proc_pidoriginatorinfo(int flavor, void *buffer, int buffersize) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_8_0);
97
39236c6e
A
98#if !TARGET_IPHONE_SIMULATOR
99
100#define PROC_SUPPRESS_SUCCESS (0)
101#define PROC_SUPPRESS_BAD_ARGUMENTS (-1)
102#define PROC_SUPPRESS_OLD_GENERATION (-2)
103#define PROC_SUPPRESS_ALREADY_SUPPRESSED (-3)
104
105int proc_suppress(pid_t pid, uint64_t *generation);
106#endif /* !TARGET_IPHONE_SIMULATOR */
107
108__END_DECLS
109
110#endif /* _LIBPROC_INTERNALH_ */
111