[][src]Function ittapi_rs::__itt_model_disable_push

pub unsafe extern "C" fn __itt_model_disable_push(x: __itt_model_disable)

@brief ANNOTATE_DISABLE_PUSH/ANNOTATE_DISABLE_POP support

disable_push/disable_pop push and pop disabling based on a parameter. Disabling observations stops processing of memory references during correctness modeling, and all annotations that occur in the disabled region. This allows description of code that is expected to be handled specially during conversion to parallelism or that is not recognized by tools (e.g. some kinds of synchronization operations.) This mechanism causes all annotations in the disabled region, other than disable_push and disable_pop, to be ignored. (For example, this might validly be used to disable an entire parallel site and the contained tasks and locking in it for data collection purposes.) The disable for collection is a more expensive operation, but reduces collector overhead significantly. This applies to BOTH correctness data collection and performance data collection. For example, a site containing a task might only enable data collection for the first 10 iterations. Both performance and correctness data should reflect this, and the program should run as close to full speed as possible when collection is disabled.