X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..8ad349bb6ed4a0be06e34c92be0d98b92e078db4:/osfmk/man/thread_sample.html diff --git a/osfmk/man/thread_sample.html b/osfmk/man/thread_sample.html index 2e2eae6be..3cbcf30ad 100755 --- a/osfmk/man/thread_sample.html +++ b/osfmk/man/thread_sample.html @@ -1 +1,43 @@ -

thread_sample


Function - Perform periodic PC sampling for a thread.

SYNOPSIS

kern_return_t   thread_sample
                (thread_act_t                     sample_thread,
                 mach_port_make_send_t               reply_port);

PARAMETERS

sample_thread
[in thread send right] Thread whose PC is to be sampled

reply_port
[in sample receive (to be converted to send) right] Port to which PC sample buffers are sent. A value of MACH_PORT_NULL stops PC sampling for the thread.

DESCRIPTION

The thread_sample function causes the program counter (PC) of the specified sample_thread to be sampled periodically (whenever the thread happens to be running at the time of the kernel's "hardclock" interrupt). The set of PC sample values obtained are saved in buffers which are sent to the specified reply_port in receive_samples messages.

RETURN VALUES

Only generic errors apply.

RELATED INFORMATION

Functions: task_sample, receive_samples. \ No newline at end of file +

thread_sample

+
+

+Function - Perform periodic PC sampling for a thread. +

SYNOPSIS

+
+kern_return_t   thread_sample
+                (thread_act_t                     sample_thread,
+                 mach_port_make_send_t               reply_port);
+
+

PARAMETERS

+
+

+

sample_thread +
+[in thread send right] +Thread whose PC is to be sampled +

+

reply_port +
+[in sample receive (to be converted to send) right] +Port to which PC +sample buffers are sent. A value of MACH_PORT_NULL stops PC +sampling for the thread. +
+

DESCRIPTION

+

+The thread_sample function causes the program counter +(PC) of the specified +sample_thread to be sampled periodically (whenever the thread happens to be +running at the time of the kernel's "hardclock" interrupt). +The set of PC sample +values obtained are saved in buffers which are sent to the specified +reply_port in +receive_samples messages. +

RETURN VALUES

+

+Only generic errors apply. +

RELATED INFORMATION

+

+Functions: +task_sample, +receive_samples.