Back to Darwin Xnu

Receive Samples

osfmk/man/receive_samples.html

latest1.1 KB
Original Source

receive_samples

Server Interface - Handles the occurrence of a PC sampling message

SYNOPSIS

**kern\_return\_t receive\_samples**** (mach\_port\_t **sample\_port,** sample\_array\_t **samples,** mach\_msg\_type\_number\_t **sample\_count** );**

PARAMETERS

sample_port[in sample (receive) right] The port to which the sample message was sent. samples[pointer to in array of vm_address_t] An array of PC sample values. sample_count[in scalar] The number of values in samples.

DESCRIPTION

A receive_samples function is called by prof_server as the result of a kernel message indicating that a set of program counter samples has been gathered. The parameter sample_port specifies the port named via a previous call to task_sample or thread_sample.

NOTES

This interface is machine word length specific because of the virtual addresses in the samples parameter.

RETURN VALUE

Irrelevant.

Functions: task_sample, thread_sample, prof_server.