Data collection API functions

int quantify_start_recording_data (void)
int quantify_stop_recording_data (void)
int quantify_is_recording_data (void)

Start and stop the recording of all count data, including code, system call, and register-window trap data.

quantify_is_recording_data returns TRUE if Quantify is recording data, FALSE otherwise. For more information, read Collecting partial data for a run.

 

int quantify_start_recording_system_calls (void)
int quantify_stop_recording_system_calls (void)
int quantify_is_recording_system_calls (void)

Start and stop the recording of system-call timing data.

quantify_is_recording_system_calls returns TRUE if Quantify is recording system calls, FALSE otherwise.

 

int quantify_start_recording_system_call (char * syscall_string)
int quantify_stop_recording_system_call (char * syscall_string)
int quantify_is_recording_system_call (char * syscall_string)

Start and stop the recording of system-call timing data for specific system calls. The first two functions take a string containing one or more system-call names or numbers. They return TRUE if the argument list is well-formed, FALSE otherwise.

quantify_is_recording_system_call takes a single system-call name or number and returns TRUE if Quantify is recording that system call, FALSE otherwise. The system-call names and numbers are located in the system header file /usr/include/sys/syscall.h.

Note:  Overall system-call timing must be enabled for these functions to have an effect. To enable system-call timing, use the –record-system-calls option or the quantify_start_recording_system_calls API function.

 

int quantify_start_recording_dynamic_library_data (void)
int quantify_stop_recording_dynamic_library_data (void)
int quantify_is_recording_dynamic_library_data (void)

Start and stop the recording of dynamic library timing data, for example, during dlopen operations (Solaris and 64-bit HP-UX) or shl_load operations (32-bit HP-UX). The function quantify_is_recording_dynamic_library_data returns TRUE if Quantify is recording dynamic library calls, FALSE otherwise. For more information, read Timing shared-library operations.

 

int quantify_start_recording_register_window_traps (void)
int quantify_stop_recording_register_window_traps (void)
int quantify_is_recording_register_window_traps (void)

Start and stop the recording of register-window trap data. The function quantify_is_recording_register_window_traps returns TRUE if Quantify is recording register-window traps, FALSE otherwise. On non-SPARC platforms, these functions always return FALSE. For more information, read Timing register-window traps.

 

int quantify_disable_recording_data (void)

Disables collection of all data by Quantify. This function always returns TRUE. Once this function is called, you cannot re-enable data collection for this process. No data is recorded and no data is saved.