#include <mach/task_info.h> also included by <mach/mach.h>

mach/task_info.h

Machine-independent task information structures and definitions. The definitions in this file are exported to the user. The kernel will translate its internal data structures to these structures as appropriate.

includes: mach/message.h, mach/machine/vm_types.h, mach/time_value.h, mach/policy.h, mach/vm_statistics.h, Availability.h, sys/cdefs.h

79 macros · 46 typedefs · 21 structs

typedeftask_flavor_t

Generic information structure to allow for expansion.

typedef natural_t task_flavor_t

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Defined values:

TASK_BASIC_INFO	Returns basic information about the task, such as the task's suspend count and number of resident pages. The structure returned is task_basic_info.
TASK_THREAD_TIMES_INFO	Returns system and user space run-times for live threads. The structure returned is task_thread_times_info.
TASK_SCHED_FIFO_INFO	Returns default FIFO scheduling policy attributes to be assigned to new threads. The structure returned is policy_fifo_base.
TASK_SCHED_RR_INFO	Returns default round-robin scheduling policy attributes to be assigned to new threads. The structure returned is policy_rr_base.
TASK_SCHED_TIMESHARE_INFO	Returns default timeshare scheduling policy attributes to be assigned to new threads. The structure returned is policy_timeshare_base.
TASK_SECURITY_TOKEN	Returns the security token for the task. The value returned is of type security_token_t.
TASK_USER_DATA	Returns user-specified information previously established via the task_set_info interface. The structure returned is task_user_data.

typedeftask_info_t

typedef integer_t *task_info_t

varying array of int

macroTASK_INFO_MAX

Deprecated, use per structure _data_t's instead

#define TASK_INFO_MAX (1024)

maximum array size

typedeftask_info_data_t

typedef integer_t task_info_data_t[TASK_INFO_MAX]

macroTASK_BASIC_INFO_32

Don't use this, use MACH_TASK_BASIC_INFO instead

#define TASK_BASIC_INFO_32 4

basic information

macroTASK_BASIC2_INFO_32

#define TASK_BASIC2_INFO_32 6

structtask_basic_info_32

size 32, align 4

integer_t	suspend_count	suspend count for task
natural_t	virtual_size	virtual memory size (bytes)
natural_t	resident_size	resident memory size (bytes)
time_value_t	user_time	total user run time for terminated threads
time_value_t	system_time	total system run time for terminated threads
policy_t	policy	default policy for new threads

typedeftask_basic_info_32_data_t

typedef struct task_basic_info_32 task_basic_info_32_data_t

typedeftask_basic_info_32_t

typedef struct task_basic_info_32 *task_basic_info_32_t

macroTASK_BASIC_INFO_32_COUNT

#define TASK_BASIC_INFO_32_COUNT (sizeof(task_basic_info_32_data_t) / sizeof(natural_t))

structtask_basic_info_64

Don't use this, use MACH_TASK_BASIC_INFO instead

size 40, align 4

integer_t	suspend_count	suspend count for task
mach_vm_size_t	virtual_size	virtual memory size (bytes)
mach_vm_size_t	resident_size	resident memory size (bytes)
time_value_t	user_time	total user run time for terminated threads
time_value_t	system_time	total system run time for terminated threads
policy_t	policy	default policy for new threads

typedeftask_basic_info_64_data_t

typedef struct task_basic_info_64 task_basic_info_64_data_t

typedeftask_basic_info_64_t

typedef struct task_basic_info_64 *task_basic_info_64_t

macroTASK_BASIC_INFO_64

#define TASK_BASIC_INFO_64 TASK_BASIC_INFO_64_2

macroTASK_BASIC_INFO_64_COUNT

#define TASK_BASIC_INFO_64_COUNT TASK_BASIC_INFO_64_2_COUNT

structtask_basic_info

localized structure - cannot be safely passed between tasks of differing sizes Don't use this, use MACH_TASK_BASIC_INFO instead

size 40, align 4

integer_t	suspend_count	suspend count for task
vm_size_t	virtual_size	virtual memory size (bytes)
vm_size_t	resident_size	resident memory size (bytes)
time_value_t	user_time	total user run time for terminated threads
time_value_t	system_time	total system run time for terminated threads
policy_t	policy	default policy for new threads

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Defines basic information for a task.

The task_basic_info structure defines the basic information array for tasks. The task_info function returns this array for a specified task.

Notes. This structure is machine word length sensitive due to the presence of the virtual address sizes.

typedeftask_basic_info_data_t

typedef struct task_basic_info task_basic_info_data_t

typedeftask_basic_info_t

typedef struct task_basic_info *task_basic_info_t

GNU Mach reference · 7.2.3 Task Information · © FSF, GFDL

task_basic_info_t

This is a pointer to a struct task_basic_info.

macroTASK_BASIC_INFO_COUNT

#define TASK_BASIC_INFO_COUNT (sizeof(task_basic_info_data_t) / sizeof(natural_t))

macroTASK_BASIC_INFO

#define TASK_BASIC_INFO TASK_BASIC_INFO_64

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Returns basic information about the task, such as the task's suspend count and number of resident pages. The structure returned is task_basic_info.

a value of task_flavor_t

macroTASK_EVENTS_INFO

#define TASK_EVENTS_INFO 2

various event counts

structtask_events_info

size 32, align 4

integer_t	faults	number of page faults
integer_t	pageins	number of actual pageins
integer_t	cow_faults	number of copy-on-write faults
integer_t	messages_sent	number of messages sent
integer_t	messages_received	number of messages received
integer_t	syscalls_mach	number of mach system calls
integer_t	syscalls_unix	number of unix system calls
integer_t	csw	number of context switches

typedeftask_events_info_data_t

typedef struct task_events_info task_events_info_data_t

typedeftask_events_info_t

typedef struct task_events_info *task_events_info_t

GNU Mach reference · 7.2.3 Task Information · © FSF, GFDL

task_events_info_t

This is a pointer to a struct task_events_info.

macroTASK_EVENTS_INFO_COUNT

#define TASK_EVENTS_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(task_events_info_data_t) / sizeof(natural_t)))

macroTASK_THREAD_TIMES_INFO

#define TASK_THREAD_TIMES_INFO 3

total times for live threads - only accurate if suspended

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Returns system and user space run-times for live threads. The structure returned is task_thread_times_info.

a value of task_flavor_t

structtask_thread_times_info

size 16, align 4

time_value_t	user_time	total user run time for live threads
time_value_t	system_time	total system run time for live threads

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Defines thread execution times information for tasks.

The task_thread_times_info structure defines thread execution time statistics for tasks. The task_info function returns these times for a specified task. The thread_info function returns this information for a specific thread.

typedeftask_thread_times_info_data_t

typedef struct task_thread_times_info task_thread_times_info_data_t

typedeftask_thread_times_info_t

typedef struct task_thread_times_info *task_thread_times_info_t

GNU Mach reference · 7.2.3 Task Information · © FSF, GFDL

task_thread_times_info_t

This is a pointer to a struct task_thread_times_info.

macroTASK_THREAD_TIMES_INFO_COUNT

#define TASK_THREAD_TIMES_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(task_thread_times_info_data_t) / sizeof(natural_t)))

macroTASK_ABSOLUTETIME_INFO

#define TASK_ABSOLUTETIME_INFO 1

structtask_absolutetime_info

size 32, align 4

uint64_t	total_user
uint64_t	total_system
uint64_t	threads_user	existing threads only
uint64_t	threads_system

typedeftask_absolutetime_info_data_t

typedef struct task_absolutetime_info task_absolutetime_info_data_t

typedeftask_absolutetime_info_t

typedef struct task_absolutetime_info *task_absolutetime_info_t

macroTASK_ABSOLUTETIME_INFO_COUNT

#define TASK_ABSOLUTETIME_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof (task_absolutetime_info_data_t) / sizeof (natural_t)))

macroTASK_KERNELMEMORY_INFO

#define TASK_KERNELMEMORY_INFO 7

structtask_kernelmemory_info

size 32, align 4

uint64_t	total_palloc	private kernel mem alloc'ed
uint64_t	total_pfree	private kernel mem freed
uint64_t	total_salloc	shared kernel mem alloc'ed
uint64_t	total_sfree	shared kernel mem freed

typedeftask_kernelmemory_info_data_t

typedef struct task_kernelmemory_info task_kernelmemory_info_data_t

typedeftask_kernelmemory_info_t

typedef struct task_kernelmemory_info *task_kernelmemory_info_t

macroTASK_KERNELMEMORY_INFO_COUNT

#define TASK_KERNELMEMORY_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof (task_kernelmemory_info_data_t) / sizeof (natural_t)))

macroTASK_SECURITY_TOKEN

#define TASK_SECURITY_TOKEN 13

CMU/MIT Mach reference · manual page · © Carnegie Mellon

Returns the security token for the task. The value returned is of type security_token_t.

a value of task_flavor_t

macroTASK_SECURITY_TOKEN_COUNT

#define TASK_SECURITY_TOKEN_COUNT ((mach_msg_type_number_t)
	        (sizeof(security_token_t) / sizeof(natural_t)))

macroTASK_AUDIT_TOKEN

#define TASK_AUDIT_TOKEN 15

macroTASK_AUDIT_TOKEN_COUNT

#define TASK_AUDIT_TOKEN_COUNT (sizeof(audit_token_t) / sizeof(natural_t))

macroTASK_AFFINITY_TAG_INFO

#define TASK_AFFINITY_TAG_INFO 16

This is experimental.

structtask_affinity_tag_info

size 16, align 4

integer_t	set_count
integer_t	min
integer_t	max
integer_t	task_count

typedeftask_affinity_tag_info_data_t

typedef struct task_affinity_tag_info task_affinity_tag_info_data_t

typedeftask_affinity_tag_info_t

typedef struct task_affinity_tag_info *task_affinity_tag_info_t

macroTASK_AFFINITY_TAG_INFO_COUNT

#define TASK_AFFINITY_TAG_INFO_COUNT (sizeof(task_affinity_tag_info_data_t) / sizeof(natural_t))

macroTASK_DYLD_INFO

#define TASK_DYLD_INFO 17

structtask_dyld_info

size 20, align 4

mach_vm_address_t	all_image_info_addr
mach_vm_size_t	all_image_info_size
integer_t	all_image_info_format

typedeftask_dyld_info_data_t

typedef struct task_dyld_info task_dyld_info_data_t

typedeftask_dyld_info_t

typedef struct task_dyld_info *task_dyld_info_t

macroTASK_DYLD_INFO_COUNT

#define TASK_DYLD_INFO_COUNT (sizeof(task_dyld_info_data_t) / sizeof(natural_t))

macroTASK_DYLD_ALL_IMAGE_INFO_32

#define TASK_DYLD_ALL_IMAGE_INFO_32 0

format value

macroTASK_DYLD_ALL_IMAGE_INFO_64

#define TASK_DYLD_ALL_IMAGE_INFO_64 1

format value

macroTASK_BASIC_INFO_64_2

Don't use this, use MACH_TASK_BASIC_INFO instead Compatibility for old 32-bit mach_vm_*_t

#define TASK_BASIC_INFO_64_2 18

64-bit capable basic info

structtask_basic_info_64_2

size 40, align 4

integer_t	suspend_count	suspend count for task
mach_vm_size_t	virtual_size	virtual memory size (bytes)
mach_vm_size_t	resident_size	resident memory size (bytes)
time_value_t	user_time	total user run time for terminated threads
time_value_t	system_time	total system run time for terminated threads
policy_t	policy	default policy for new threads

typedeftask_basic_info_64_2_data_t

typedef struct task_basic_info_64_2 task_basic_info_64_2_data_t

typedeftask_basic_info_64_2_t

typedef struct task_basic_info_64_2 *task_basic_info_64_2_t

macroTASK_BASIC_INFO_64_2_COUNT

#define TASK_BASIC_INFO_64_2_COUNT (sizeof(task_basic_info_64_2_data_t) / sizeof(natural_t))

macroTASK_EXTMOD_INFO

#define TASK_EXTMOD_INFO 19

structtask_extmod_info

size 64, align 4

unsigned char[16]	task_uuid
vm_extmod_statistics_data_t	extmod_statistics

typedeftask_extmod_info_data_t

typedef struct task_extmod_info task_extmod_info_data_t

typedeftask_extmod_info_t

typedef struct task_extmod_info *task_extmod_info_t

macroTASK_EXTMOD_INFO_COUNT

#define TASK_EXTMOD_INFO_COUNT (sizeof(task_extmod_info_data_t) / sizeof(natural_t))

macroMACH_TASK_BASIC_INFO

#define MACH_TASK_BASIC_INFO 20

always 64-bit basic info

structmach_task_basic_info

size 48, align 4

mach_vm_size_t	virtual_size	virtual memory size (bytes)
mach_vm_size_t	resident_size	resident memory size (bytes)
mach_vm_size_t	resident_size_max	maximum resident memory size (bytes)
time_value_t	user_time	total user run time for terminated threads
time_value_t	system_time	total system run time for terminated threads
policy_t	policy	default policy for new threads
integer_t	suspend_count	suspend count for task

typedefmach_task_basic_info_data_t

typedef struct mach_task_basic_info mach_task_basic_info_data_t

typedefmach_task_basic_info_t

typedef struct mach_task_basic_info *mach_task_basic_info_t

macroMACH_TASK_BASIC_INFO_COUNT

#define MACH_TASK_BASIC_INFO_COUNT (sizeof(mach_task_basic_info_data_t) / sizeof(natural_t))

macroTASK_POWER_INFO

#define TASK_POWER_INFO 21

structtask_power_info

size 48, align 4

uint64_t	total_user
uint64_t	total_system
uint64_t	task_interrupt_wakeups
uint64_t	task_platform_idle_wakeups
uint64_t	task_timer_wakeups_bin_1
uint64_t	task_timer_wakeups_bin_2

typedeftask_power_info_data_t

typedef struct task_power_info task_power_info_data_t

typedeftask_power_info_t

typedef struct task_power_info *task_power_info_t

macroTASK_POWER_INFO_COUNT

#define TASK_POWER_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof (task_power_info_data_t) / sizeof (natural_t)))

macroTASK_VM_INFO

#define TASK_VM_INFO 22

macroTASK_VM_INFO_PURGEABLE

#define TASK_VM_INFO_PURGEABLE 23

structtask_vm_info

size 372, align 4

mach_vm_size_t	virtual_size	virtual memory size (bytes)
integer_t	region_count	number of memory regions
integer_t	page_size
mach_vm_size_t	resident_size	resident memory size (bytes)
mach_vm_size_t	resident_size_peak	peak resident size (bytes)
mach_vm_size_t	device
mach_vm_size_t	device_peak
mach_vm_size_t	internal
mach_vm_size_t	internal_peak
mach_vm_size_t	external
mach_vm_size_t	external_peak
mach_vm_size_t	reusable
mach_vm_size_t	reusable_peak
mach_vm_size_t	purgeable_volatile_pmap
mach_vm_size_t	purgeable_volatile_resident
mach_vm_size_t	purgeable_volatile_virtual
mach_vm_size_t	compressed
mach_vm_size_t	compressed_peak
mach_vm_size_t	compressed_lifetime
mach_vm_size_t	phys_footprint	added for rev1
mach_vm_address_t	min_address	added for rev2
mach_vm_address_t	max_address
int64_t	ledger_phys_footprint_peak	added for rev3
int64_t	ledger_purgeable_nonvolatile
int64_t	ledger_purgeable_novolatile_compressed
int64_t	ledger_purgeable_volatile
int64_t	ledger_purgeable_volatile_compressed
int64_t	ledger_tag_network_nonvolatile
int64_t	ledger_tag_network_nonvolatile_compressed
int64_t	ledger_tag_network_volatile
int64_t	ledger_tag_network_volatile_compressed
int64_t	ledger_tag_media_footprint
int64_t	ledger_tag_media_footprint_compressed
int64_t	ledger_tag_media_nofootprint
int64_t	ledger_tag_media_nofootprint_compressed
int64_t	ledger_tag_graphics_footprint
int64_t	ledger_tag_graphics_footprint_compressed
int64_t	ledger_tag_graphics_nofootprint
int64_t	ledger_tag_graphics_nofootprint_compressed
int64_t	ledger_tag_neural_footprint
int64_t	ledger_tag_neural_footprint_compressed
int64_t	ledger_tag_neural_nofootprint
int64_t	ledger_tag_neural_nofootprint_compressed
uint64_t	limit_bytes_remaining	added for rev4
integer_t	decompressions	added for rev5
int64_t	ledger_swapins	added for rev6
int64_t	ledger_tag_neural_nofootprint_total	added for rev7
int64_t	ledger_tag_neural_nofootprint_peak

typedeftask_vm_info_data_t

typedef struct task_vm_info task_vm_info_data_t

typedeftask_vm_info_t

typedef struct task_vm_info *task_vm_info_t

macroTASK_VM_INFO_COUNT

#define TASK_VM_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof (task_vm_info_data_t) / sizeof (natural_t)))

macroTASK_VM_INFO_REV7_COUNT

The capacity of task_info_t in mach_types.defs also needs to be adjusted

#define TASK_VM_INFO_REV7_COUNT TASK_VM_INFO_COUNT

macroTASK_VM_INFO_REV6_COUNT

#define TASK_VM_INFO_REV6_COUNT /* doesn't include neural total and peak */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV7_COUNT - 4))

macroTASK_VM_INFO_REV5_COUNT

#define TASK_VM_INFO_REV5_COUNT /* doesn't include ledger swapins */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV6_COUNT - 2))

macroTASK_VM_INFO_REV4_COUNT

#define TASK_VM_INFO_REV4_COUNT /* doesn't include decompressions */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV5_COUNT - 1))

macroTASK_VM_INFO_REV3_COUNT

#define TASK_VM_INFO_REV3_COUNT /* doesn't include limit bytes */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV4_COUNT - 2))

macroTASK_VM_INFO_REV2_COUNT

#define TASK_VM_INFO_REV2_COUNT /* doesn't include extra ledgers info */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV3_COUNT - 42))

macroTASK_VM_INFO_REV1_COUNT

#define TASK_VM_INFO_REV1_COUNT /* doesn't include min and max address */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV2_COUNT - 4))

macroTASK_VM_INFO_REV0_COUNT

#define TASK_VM_INFO_REV0_COUNT /* doesn't include phys_footprint */
	((mach_msg_type_number_t) (TASK_VM_INFO_REV1_COUNT - 2))

typedeftask_purgable_info_t

typedef struct vm_purgeable_info task_purgable_info_t

macroTASK_TRACE_MEMORY_INFO

#define TASK_TRACE_MEMORY_INFO 24

no longer supported

structtask_trace_memory_info

size 24, align 4

uint64_t	user_memory_address	address of start of trace memory buffer
uint64_t	buffer_size	size of buffer in bytes
uint64_t	mailbox_array_size	size of mailbox area in bytes

typedeftask_trace_memory_info_data_t

typedef struct task_trace_memory_info task_trace_memory_info_data_t

typedeftask_trace_memory_info_t

typedef struct task_trace_memory_info * task_trace_memory_info_t

macroTASK_TRACE_MEMORY_INFO_COUNT

#define TASK_TRACE_MEMORY_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(task_trace_memory_info_data_t) / sizeof(natural_t)))

macroTASK_WAIT_STATE_INFO

#define TASK_WAIT_STATE_INFO 25

deprecated.

structtask_wait_state_info

size 32, align 4

uint64_t	total_wait_state_time	Time that all threads past and present have been in a wait state
uint64_t	total_wait_sfi_state_time	Time that threads have been in SFI wait (should be a subset of total wait state time
uint32_t[4]	_reserved

typedeftask_wait_state_info_data_t

typedef struct task_wait_state_info task_wait_state_info_data_t

typedeftask_wait_state_info_t

typedef struct task_wait_state_info * task_wait_state_info_t

macroTASK_WAIT_STATE_INFO_COUNT

#define TASK_WAIT_STATE_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(task_wait_state_info_data_t) / sizeof(natural_t)))

macroTASK_POWER_INFO_V2

#define TASK_POWER_INFO_V2 26

structgpu_energy_data

size 32, align 4

uint64_t	task_gpu_utilisation
uint64_t	task_gpu_stat_reserved0
uint64_t	task_gpu_stat_reserved1
uint64_t	task_gpu_stat_reserved2

typedefgpu_energy_data

typedef struct gpu_energy_data gpu_energy_data;

typedefgpu_energy_data_t

typedef gpu_energy_data *gpu_energy_data_t

structtask_power_info_v2

size 104, align 4

task_power_info_data_t	cpu_energy
gpu_energy_data	gpu_energy
uint64_t	task_energy
uint64_t	task_ptime
uint64_t	task_pset_switches

typedeftask_power_info_v2_data_t

typedef struct task_power_info_v2 task_power_info_v2_data_t

typedeftask_power_info_v2_t

typedef struct task_power_info_v2 *task_power_info_v2_t

macroTASK_POWER_INFO_V2_COUNT_OLD

#define TASK_POWER_INFO_V2_COUNT_OLD ((mach_msg_type_number_t) (sizeof (task_power_info_v2_data_t) - sizeof(uint64_t)*2) / sizeof (natural_t))

macroTASK_POWER_INFO_V2_COUNT

#define TASK_POWER_INFO_V2_COUNT ((mach_msg_type_number_t) (sizeof (task_power_info_v2_data_t) / sizeof (natural_t)))

macroTASK_VM_INFO_PURGEABLE_ACCOUNT

#define TASK_VM_INFO_PURGEABLE_ACCOUNT 27

Used for xnu purgeable vm unit tests

macroTASK_FLAGS_INFO

#define TASK_FLAGS_INFO 28

return t_flags field

structtask_flags_info

size 4, align 4

uint32_t

flags

task flags

typedeftask_flags_info_data_t

typedef struct task_flags_info task_flags_info_data_t

typedeftask_flags_info_t

typedef struct task_flags_info * task_flags_info_t

macroTASK_FLAGS_INFO_COUNT

#define TASK_FLAGS_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(task_flags_info_data_t) / sizeof (natural_t)))

macroTF_LP64

#define TF_LP64 0x00000001

task has 64-bit addressing

macroTF_64B_DATA

#define TF_64B_DATA 0x00000002

task has 64-bit data registers

macroTASK_DEBUG_INFO_INTERNAL

#define TASK_DEBUG_INFO_INTERNAL 29

Used for kernel internal development tests.

macroTASK_SECURITY_CONFIG_INFO

#define TASK_SECURITY_CONFIG_INFO 32

Runtime security mitigations configuration for the task

structtask_security_config_info

size 4, align 4

uint32_t

config

Configuration bitmask

typedeftask_security_config_info_t

typedef struct task_security_config_info * task_security_config_info_t

macroTASK_SECURITY_CONFIG_INFO_COUNT

#define TASK_SECURITY_CONFIG_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(struct task_security_config_info) / sizeof(natural_t)))

macroTASK_IPC_SPACE_POLICY_INFO

#define TASK_IPC_SPACE_POLICY_INFO 33

Runtime security mitigations configuration for the task

structtask_ipc_space_policy_info

size 4, align 4

uint32_t

space_policy

Configuration bitmask

typedeftask_ipc_space_policy_info_t

typedef struct task_ipc_space_policy_info * task_ipc_space_policy_info_t

macroTASK_IPC_SPACE_POLICY_INFO_COUNT

#define TASK_IPC_SPACE_POLICY_INFO_COUNT ((mach_msg_type_number_t)
	        (sizeof(struct task_ipc_space_policy_info) / sizeof(natural_t)))

typedeftask_exc_guard_behavior_t

Type to control EXC_GUARD delivery options for a task via task_get/set_exc_guard_behavior interface(s).

typedef uint32_t task_exc_guard_behavior_t

macroTASK_EXC_GUARD_NONE

EXC_GUARD optional delivery settings on a per-task basis

#define TASK_EXC_GUARD_NONE 0x00

macroTASK_EXC_GUARD_VM_DELIVER

#define TASK_EXC_GUARD_VM_DELIVER 0x01

Deliver virtual memory EXC_GUARD exceptions

macroTASK_EXC_GUARD_VM_ONCE

#define TASK_EXC_GUARD_VM_ONCE 0x02

Deliver them only once

macroTASK_EXC_GUARD_VM_CORPSE

#define TASK_EXC_GUARD_VM_CORPSE 0x04

Deliver them via a forked corpse

macroTASK_EXC_GUARD_VM_FATAL

#define TASK_EXC_GUARD_VM_FATAL 0x08

Virtual Memory EXC_GUARD delivery is fatal

macroTASK_EXC_GUARD_VM_ALL

#define TASK_EXC_GUARD_VM_ALL 0x0f

macroTASK_EXC_GUARD_MP_DELIVER

#define TASK_EXC_GUARD_MP_DELIVER 0x10

Deliver mach port EXC_GUARD exceptions

macroTASK_EXC_GUARD_MP_ONCE

#define TASK_EXC_GUARD_MP_ONCE 0x20

Deliver them only once

macroTASK_EXC_GUARD_MP_CORPSE

#define TASK_EXC_GUARD_MP_CORPSE 0x40

Deliver them via a forked corpse

macroTASK_EXC_GUARD_MP_FATAL

#define TASK_EXC_GUARD_MP_FATAL 0x80

mach port EXC_GUARD delivery is fatal

macroTASK_EXC_GUARD_MP_ALL

#define TASK_EXC_GUARD_MP_ALL 0xf0

macroTASK_EXC_GUARD_ALL

#define TASK_EXC_GUARD_ALL 0xff

All optional deliver settings

typedeftask_corpse_forking_behavior_t

Type to control corpse forking options for a task via task_get/set_corpse_forking_behavior interface(s).

typedef uint32_t task_corpse_forking_behavior_t

macroTASK_CORPSE_FORKING_DISABLED_MEM_DIAG

#define TASK_CORPSE_FORKING_DISABLED_MEM_DIAG 0x01

Disable corpse forking because the task is running under a diagnostic tool

macroTASK_SCHED_TIMESHARE_INFO

#define TASK_SCHED_TIMESHARE_INFO 10

Returns default timeshare scheduling policy attributes to be assigned to new threads. The structure returned is policy_timeshare_base.

a value of task_flavor_t

macroTASK_SCHED_RR_INFO

#define TASK_SCHED_RR_INFO 11

Returns default round-robin scheduling policy attributes to be assigned to new threads. The structure returned is policy_rr_base.

a value of task_flavor_t

macroTASK_SCHED_FIFO_INFO

#define TASK_SCHED_FIFO_INFO 12

Returns default FIFO scheduling policy attributes to be assigned to new threads. The structure returned is policy_fifo_base.

a value of task_flavor_t

macroTASK_SCHED_INFO

#define TASK_SCHED_INFO 14