## etap_probe

System Trap - Record event data in the kernel's ETAP buffer(s).

### SYNOPSIS

    #include<mach/etap.h>

    kern_return_t   etap_probe
                    (int                                   event_id,
                     event_id                             data_size,
                     etap_data_t                        etap_data_t);

### PARAMETERS

event_id
  A user defined value used to identify the event.

data_size
  The size (in bytes) of the data being passed. Note: The data size is limited to ETAP_DATA_SIZE, (defined in mach/etap.h).

data
  A pointer to the event data being passed.

### DESCRIPTION

Application programmers may instrument their applications with user-level probes, using the etap_probe system call. All event data passed to the kernel via etap_probe is recorded in the kernel's ETAP monitored buffer(s). Each record includes a time stamp.

### RETURN VALUES

KERN_SUCCESS
  The call was performed successfully.

KERN_INVALID_ARGUMENT
  The specified data size exceeds ETAP_DATA_SIZE.

KERN_NO_ACCESS
  The tracing of user events is currently enabled.

KERN_FAILURE
  ETAP is not configured in the kernel.

### RELATED INFORMATION

Functions: etap_trace_thread, etap_trace_event, etap_get_info.