mach/mach_host.h

Creates a named memory entry backed by the given memory object (pager), returning a send right in entry_handle that can be mapped with vm_map or mach_vm_map. If pager is MEMORY_OBJECT_NULL and internal is TRUE, a fresh anonymous VM object of the given size backs the entry. permission gives the entry's protection. Returns KERN_INVALID_HOST if host is HOST_NULL, KERN_INVALID_ARGUMENT if no VM object can be derived from pager. Since user space has no way to create a memory_object_t, the pager-backed form is only usable from kernel/IOKit code; see mach_make_memory_entry_64 for the user-level way to make named entries.

Registers notify_port to receive a one-shot kernel notification message. notify_type is one of: HOST_NOTIFY_CALENDAR_CHANGE a host_calendar_changed message when the wall-clock (calendar) time changes discontinuously HOST_NOTIFY_CALENDAR_SET a host_calendar_set message when the calendar time is explicitly set The message is sent to the supplied send-once right and the registration is consumed; a caller wanting further notifications must re-register. The port is made immovable as a side effect. Returns KERN_INVALID_ARGUMENT for a null host or unknown notify_type, KERN_INVALID_CAPABILITY for an invalid or dead port.

Returns an array of lockgroup_info_t structures, one per lock group registered in the kernel. Each entry carries the group's name and its counts of spin locks, mutexes, and reader-writer locks; on CONFIG_DTRACE kernels the mutex/spin contention statistics (held, miss, wait counts) are filled in as well. The array is returned out of line and should be deallocated by the caller with vm_deallocate. Returns KERN_INVALID_HOST if host is HOST_NULL. Consumed by lock-profiling tools such as lockstat.

Obsolete; removed from the kernel (the MIG slot is skipped and marked OBSOLETE in mach_host.defs). Formerly registered a user-space Mach voucher attribute manager to back the well-known attribute key given in key, returning a control port for the new attribute. User-space voucher attribute managers are no longer supported; the call fails with MIG_BAD_ID. See host_create_mach_voucher for the surviving voucher interface.

Returns the ATM (Activity Trace Manager) diagnostic configuration word. Implemented entirely in Libsystem_kernel: the value is read from the commpage (COMM_PAGE_READ of ATM_DIAGNOSTIC_CONFIG), so no message is sent and the call always returns KERN_SUCCESS. The value is set by the privileged host_set_atm_diagnostic_flag call.

Returns kernel zone allocator statistics: parallel out-of-line arrays of zone names and mach_zone_info_t (as mach_zone_info), plus a mach_memory_info_array_t describing wired-memory allocation sites (kernel tags and kexts). If host is the privileged host port and the caller is root, full information is returned; otherwise the info is redacted (sizes zeroed, kalloc-type zones coalesced). On some platforms an unredacted call also requires the com.apple.private.memoryinfo entitlement and is rate-limited. The caller should vm_deallocate the returned arrays. Consumed by zprint(1) and memorymaintenanced.

Returns the multiuser configuration flags word (e.g. kIsMultiUserDevice), read directly from the commpage (COMM_PAGE_READ of MULTIUSER_CONFIG) without a kernel call. Only meaningful on embedded (iOS-family) devices; elsewhere returns KERN_NOT_SUPPORTED.

Sets *multiuser_mode to 1 if the device is configured as a multiuser (shared) device, 0 otherwise, by testing kIsMultiUserDevice in the commpage multiuser configuration flags (see host_get_multiuser_config_flags). Returns KERN_NOT_SUPPORTED where no multiuser configuration exists (macOS, simulator).