XXNU Source Handbook Download offline version from here
Part 09 · Chapter 09.42

Mach messages: prof

Message catalog and dispatch · All subsystem ranges · Kernel entry map

osfmk/mach/prof.defs. Not listed as a separate subsystem in this checkout's mig_e table. Local bodies, generated interfaces and compatibility aliases are distinguished below; a declaration alone does not establish an active kernel message endpoint. Registration evidence: mig_e.

Reading these entries

IDs are computed from the explicit preprocessing profiles in the catalog guide, counting both routines and skip slots. They are not discovered from a running kernel. Each entry retains all observed names/declaration locations; the displayed fields come from the first non-skipped profile. Alternative declarations can have different fields. simpleroutine is one-way at the MIG interface level.

An interface contract block quotes the adjacent local .defs comment with whitespace normalized. Mechanism paragraphs explain selected implementation decisions. Local body links and call names identify implementation evidence; syntactic call lists are reading aids, not a proof that every listed call executes on every path. Short complete implementation bodies are included where especially useful.

Complete routine and reserved-slot catalog

2450: samples

Deliver a batch of program-counter profiling samples to the external profiling receiver.

Mechanism: This profiling-output protocol declares one-way delivery to an external profile-server destination. The local source inventory resolves no same-symbol receiver/body, and the subsystem is not registered in mig_e. The payload contract is retained without asserting an active modern kernel producer or reconstructing the collector.

Declarations: samples (server64, server32, client64, client32, libsyscall64, sender64, local64).

Fields after preprocessing (server64):

simpleroutine samples(
   reply_port : mach_port_t;
   samples : sample_array_t);

Implementation boundary: no same-symbol receiver body was resolved in the indexed local C/C++ implementation files.

2451: notices

Deliver profiling notices to the external profiling receiver.

Mechanism: This profiling-output protocol declares one-way delivery to an external profile-server destination. The local source inventory resolves no same-symbol receiver/body, and the subsystem is not registered in mig_e. The payload contract is retained without asserting an active modern kernel producer or reconstructing the collector.

Declarations: notices (server64, server32, client64, client32, libsyscall64, sender64, local64).

Fields after preprocessing (server64):

simpleroutine notices(
   reply_port : mach_port_t;
   samples : sample_array_t;
 msgoption options : mach_msg_options_t);

Implementation boundary: no same-symbol receiver body was resolved in the indexed local C/C++ implementation files.

Search the handbook

Search every chapter, interface and code excerpt.

    Diagram

    Source preview

    Open full file