## etap_trace_thread

Function - Set a thread's ETAP trace status.

### SYNOPSIS

    #include<mach/etap.h>

    kern_return_t   etap_trace_thread
                    (thread_act_t                     target_thread,
                     boolean_t                               active);

### PARAMETERS

target_thread
  The port of the thread who's ETAP trace status will be toggled.

active
  The boolean value (either TRUE or FALSE) stating whether the thread's ETAP trace status will be activated or not. Passing TRUE will enable the thread's trace status and FALSE will deactivate it.

### DESCRIPTION

The etap_trace_thread system call is used to toggle the ETAP trace status of a thread.

### RETURN VALUES

KERN_SUCCESS
  The call was performed successfully.

KERN_INVALID_ARGUMENT
  The value of target_thread does not name a valid thread.

KERN_FAILURE
  ETAP is not configured in the kernel.

### RELATED INFORMATION

Functions: etap_probe, etap_trace_event, etap_get_info.