libimobiledevice  1.4.0
API Documentation - Return to Homepage

◆ ostrace_start_activity()

LIBIMOBILEDEVICE_API ostrace_error_t ostrace_start_activity ( ostrace_client_t client,
plist_t options,
ostrace_activity_cb_t callback,
void * user_data )

Starts capturing OS trace activity data of the device using a callback.

Use ostrace_stop_activity() to stop receiving the ostrace.

Parameters
clientThe ostrace client to use
optionsOptions dictionary to pass to StartActivity request. Valid options are MessageFilter (PLIST_INT, default 65535), Pid (PLIST_INT, default -1), and StreamFlags (PLIST_INT, default 60)
callbackCallback to receive data from ostrace.
user_dataCustom pointer passed to the callback function.
user_data_free_funcFunction pointer that will be called when the activity is stopped to release user_data. Can be NULL for none.
Returns
OSTRACE_E_SUCCESS on success, OSTRACE_E_INVALID_ARG when one or more parameters are invalid or OSTRACE_E_UNKNOWN_ERROR when an unspecified error occurs or an ostrace activity has already been started.