《高等数值分析（高性能计算/并行计算）》课程教学资源（参考资料）OpenMP Application Programming Interface Version 5.0

4.4.4.20 ompt_target_t................. 448 4.4.4.21 ompt_parallel_f1ag_t.·· 448 4.4.4.22 ompt_target_map_flag_t 149 4.4.4.23 ompt_dependence_type_t 450 4.4.4.24 ompt_cancel_flag_t 450 4.4.4.25 451 4.4.4.26 ompt_state_t 452 4.4.427 ompt_frame_t 454 4.4.4.28 ompt_frame_flag_t 455 4.4.4.29 ompt_wait_idt 456 4.5 OMPT Tool Callback Signatures and Trace Records................ 457 4.5.1 Initialization and Finalization Callback Signature.......·· 457 4.5.1.1 ompt_initialize_t 457 4.5.1.2 ompt finalize t.. 458 4.5.2 Event Callback Signatures and Trace Records 459 4.5.2.1 ompt_callback_thread begin t 459 4.5.2.2 ompt_callback_thread_end_t 460 4.5.2.3 ompt_callback_parallel_begin_t 461 452.4 ompt_callback_parallel_end_t 463 452.5 ompt_callback_work_t...... 464 4.5.2.6 ompt_callback_dispatch_t 46 4.5.2.7 ompt_callback_task_create_t 467 4.5.2.8 ompt_callback_dependences_t 468 4.5.2.9 ompt_callback_task_dependence_t 470 4.5.2.10 ompt_callback_task_schedule_t 470 4.5.2.11 ompt_callback_implicit_task_t 471 4.5.2.12 ompt_callback_master_t.... 473 4.5.2.13 ompt_callback_sync_region_t 474 4.5.2.14 ompt_callback_mutex_acquire_t 476 4.5.2.15 ompt_callback_mutex_t... 477 4.5.2.16 ompt_callback_nest_lock_t 479 4.5.2.17 ompt_cal1 back_f1usht........····......··. 480 4.5.2.18 ompt_callback_cancel_t 481 OpenMP API-Version 5.0 November 2018

4.4.4.20 ompt_target_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 4.4.4.21 ompt_parallel_flag_t . . . . . . . . . . . . . . . . . . . . . . . 448 4.4.4.22 ompt_target_map_flag_t . . . . . . . . . . . . . . . . . . . . . 449 4.4.4.23 ompt_dependence_type_t . . . . . . . . . . . . . . . . . . . . . 450 4.4.4.24 ompt_cancel_flag_t . . . . . . . . . . . . . . . . . . . . . . . . 450 4.4.4.25 ompt_hwid_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 4.4.4.26 ompt_state_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452 4.4.4.27 ompt_frame_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 4.4.4.28 ompt_frame_flag_t . . . . . . . . . . . . . . . . . . . . . . . . . 455 4.4.4.29 ompt_wait_id_t . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 4.5 OMPT Tool Callback Signatures and Trace Records . . . . . . . . . . . . . . . . 457 4.5.1 Initialization and Finalization Callback Signature . . . . . . . . . . . . . . . 457 4.5.1.1 ompt_initialize_t . . . . . . . . . . . . . . . . . . . . . . . . . 457 4.5.1.2 ompt_finalize_t . . . . . . . . . . . . . . . . . . . . . . . . . . . 458 4.5.2 Event Callback Signatures and Trace Records . . . . . . . . . . . . . . . . . 459 4.5.2.1 ompt_callback_thread_begin_t . . . . . . . . . . . . . . . . 459 4.5.2.2 ompt_callback_thread_end_t . . . . . . . . . . . . . . . . . . 460 4.5.2.3 ompt_callback_parallel_begin_t . . . . . . . . . . . . . . . 461 4.5.2.4 ompt_callback_parallel_end_t . . . . . . . . . . . . . . . . 463 4.5.2.5 ompt_callback_work_t . . . . . . . . . . . . . . . . . . . . . . . 464 4.5.2.6 ompt_callback_dispatch_t . . . . . . . . . . . . . . . . . . . 465 4.5.2.7 ompt_callback_task_create_t . . . . . . . . . . . . . . . . . 467 4.5.2.8 ompt_callback_dependences_t . . . . . . . . . . . . . . . . . 468 4.5.2.9 ompt_callback_task_dependence_t . . . . . . . . . . . . . . 470 4.5.2.10 ompt_callback_task_schedule_t . . . . . . . . . . . . . . . 470 4.5.2.11 ompt_callback_implicit_task_t . . . . . . . . . . . . . . . 471 4.5.2.12 ompt_callback_master_t . . . . . . . . . . . . . . . . . . . . . 473 4.5.2.13 ompt_callback_sync_region_t . . . . . . . . . . . . . . . . . 474 4.5.2.14 ompt_callback_mutex_acquire_t . . . . . . . . . . . . . . . 476 4.5.2.15 ompt_callback_mutex_t . . . . . . . . . . . . . . . . . . . . . . 477 4.5.2.16 ompt_callback_nest_lock_t . . . . . . . . . . . . . . . . . . . 479 4.5.2.17 ompt_callback_flush_t . . . . . . . . . . . . . . . . . . . . . . 480 4.5.2.18 ompt_callback_cancel_t . . . . . . . . . . . . . . . . . . . . . 481 x OpenMP API – Version 5.0 November 2018

4.5.2.19 ompt_callback_device_initialize_t............482 4.5.2.20 ompt_callback_device_finalize_t.............. 484 4.5.2.21 ompt_callback_device_load_t... 484 4.5.2.22 ompt_callback_device_unload_t 486 4.5.2.23 ompt_callback_buffer_request_t 486 4.5.2.24 ompt_callback_buffer_complete_t 487 4.5.2.25 ompt_callback_target_data_op_t,·············· 488 4.5.2.26 ompt_callback_target_t.·.· 490 4.5.2.27 ompt_callback_target_map._t.··. 492 4.5.2.28 ompt_callback_target_submit_t 49 4.5.2.29 ompt_callback_control_tool_t 495 4.6 OMPT Runtime Entry Points for Tools 497 4.6.1 Entry Points in the OMPT Callback Interface 497 4.6.1.1 ompt_enumerate_states._t,,,,,, 498 4.6.1.2 ompt_enumerate_mutex_impls_t 499 4.6.13 ompt_set_callbackt 500 4.6.1.4 ompt_get_callback_t 502 4.6.1.5 ompt_get_thread_data_t 503 4.6.1.6 ompt_get_num_procs_t 503 4.6.1.7 ompt_get_num_places_t 504 4.6.1.8 ompt_get_place_proc_ids_t 505 4.6.19 ompt_get_place_num_t 506 4.6.1.10 ompt_get_partition place_nums_t 507 4.6.1.11 ompt_get_proc_id t 508 4.6.1.12 ompt_get_state_t,··,,···,·, 508 4.6.l.l3ompt_get_para11e1_info_t·········· 510 4.6.1.14 ompt_get_task_info_t.. 512 4.6.1.15 ompt_get_task_memory_t 。。。。。。。。。。。。。 514 4.6.1.16 ompt_get_target_info_t 515 4.6.1.17 ompt_get_num_devices_t 516 4.6.1.18 ompt_get_unique_id_t 517 4.6.1.19 ompt_finalize_tool_t 517 Contents xi

4.5.2.19 ompt_callback_device_initialize_t . . . . . . . . . . . . 482 4.5.2.20 ompt_callback_device_finalize_t . . . . . . . . . . . . . . 484 4.5.2.21 ompt_callback_device_load_t . . . . . . . . . . . . . . . . . 484 4.5.2.22 ompt_callback_device_unload_t . . . . . . . . . . . . . . . 486 4.5.2.23 ompt_callback_buffer_request_t . . . . . . . . . . . . . . . 486 4.5.2.24 ompt_callback_buffer_complete_t . . . . . . . . . . . . . . 487 4.5.2.25 ompt_callback_target_data_op_t . . . . . . . . . . . . . . . 488 4.5.2.26 ompt_callback_target_t . . . . . . . . . . . . . . . . . . . . . 490 4.5.2.27 ompt_callback_target_map_t . . . . . . . . . . . . . . . . . . 492 4.5.2.28 ompt_callback_target_submit_t . . . . . . . . . . . . . . . 494 4.5.2.29 ompt_callback_control_tool_t . . . . . . . . . . . . . . . . 495 4.6 OMPT Runtime Entry Points for Tools . . . . . . . . . . . . . . . . . . . . . . . 497 4.6.1 Entry Points in the OMPT Callback Interface . . . . . . . . . . . . . . . . . 497 4.6.1.1 ompt_enumerate_states_t . . . . . . . . . . . . . . . . . . . . 498 4.6.1.2 ompt_enumerate_mutex_impls_t . . . . . . . . . . . . . . . . 499 4.6.1.3 ompt_set_callback_t . . . . . . . . . . . . . . . . . . . . . . . 500 4.6.1.4 ompt_get_callback_t . . . . . . . . . . . . . . . . . . . . . . . 502 4.6.1.5 ompt_get_thread_data_t . . . . . . . . . . . . . . . . . . . . . 503 4.6.1.6 ompt_get_num_procs_t . . . . . . . . . . . . . . . . . . . . . . . 503 4.6.1.7 ompt_get_num_places_t . . . . . . . . . . . . . . . . . . . . . . 504 4.6.1.8 ompt_get_place_proc_ids_t . . . . . . . . . . . . . . . . . . . 505 4.6.1.9 ompt_get_place_num_t . . . . . . . . . . . . . . . . . . . . . . . 506 4.6.1.10 ompt_get_partition_place_nums_t . . . . . . . . . . . . . . 507 4.6.1.11 ompt_get_proc_id_t . . . . . . . . . . . . . . . . . . . . . . . . 508 4.6.1.12 ompt_get_state_t . . . . . . . . . . . . . . . . . . . . . . . . . . 508 4.6.1.13 ompt_get_parallel_info_t . . . . . . . . . . . . . . . . . . . 510 4.6.1.14 ompt_get_task_info_t . . . . . . . . . . . . . . . . . . . . . . . 512 4.6.1.15 ompt_get_task_memory_t . . . . . . . . . . . . . . . . . . . . . 514 4.6.1.16 ompt_get_target_info_t . . . . . . . . . . . . . . . . . . . . . 515 4.6.1.17 ompt_get_num_devices_t . . . . . . . . . . . . . . . . . . . . . 516 4.6.1.18 ompt_get_unique_id_t . . . . . . . . . . . . . . . . . . . . . . . 517 4.6.1.19 ompt_finalize_tool_t . . . . . . . . . . . . . . . . . . . . . . . 517 Contents xi

4.6.2 Entry Points in the OMPT Device Tracing Interface............. 518 4.6.2.1 ompt_get_device_num_procs_t 518 4.6.2.2 ompt_get_device_time_t::·:·········· 519 4.6.2.3 ompt_translate_time_t..................... 520 4.6.2.4 ompt_set_trace_ompt_t.,.,,,,,,,.,., 521 4.6.2.5 ompt_set_trace_native_t 。。。年。。。。。。。。。7.4。 522 4.6.2.6 ompt_start_trace_t 523 4.6.2.7 ompt_pause_trace_t 524 4.6.2.8 ompt_flush_tracet 525 4.6.2.9 ompt_stop_trace_t 526 4.6.2.10 ompt_advance_buffer_cursor_t 527 4.6.2.11 ompt_get_record_type_t.... 528 4.6.2.12 ompt_get_record_ompt_t, 529 4.6.2.13 ompt_get_record_native_t 530 4.6.2.14 ompt_get_record_abstract_t. 531 4.6.3 Lookup Entry Points:ompt_function_lookup_t 。。。。。。。。 531 5 OMPD Interface 533 5.1 OMPD Interfaces Definitions 534 5.2 Activating an OMPD Tool..... 534 5.2.1 Enabling the Runtime for OMPD 534 5.2.2 ompd_dll_locations 535 5.2.3 ompd_dll_locations_valid 536 5.3 OMPD Data Types 536 5.3.1 Size Type 536 5.3.2 Wait ID Type 537 5.3.3 Basic Value Types...........................,... 537 5.3.4 Address Type.......... 538 5.3.5 Frame Information Type·················· 538 5.3.6 System Device Identifiers 539 5.3.7 Native Thread Identifiers... 。。。。。。。 539 5.3.8 OMPD Handle Types 。。。。。。。。。。。。。。。。。。。。。。。。。 540 53.9 OMPD Scope Types 541 5.3.10 ICV ID Type 542 OpenMP API-Version 5.0 November 2018

4.6.2 Entry Points in the OMPT Device Tracing Interface . . . . . . . . . . . . . 518 4.6.2.1 ompt_get_device_num_procs_t . . . . . . . . . . . . . . . . . 518 4.6.2.2 ompt_get_device_time_t . . . . . . . . . . . . . . . . . . . . . 519 4.6.2.3 ompt_translate_time_t . . . . . . . . . . . . . . . . . . . . . . 520 4.6.2.4 ompt_set_trace_ompt_t . . . . . . . . . . . . . . . . . . . . . . 521 4.6.2.5 ompt_set_trace_native_t . . . . . . . . . . . . . . . . . . . . 522 4.6.2.6 ompt_start_trace_t . . . . . . . . . . . . . . . . . . . . . . . . 523 4.6.2.7 ompt_pause_trace_t . . . . . . . . . . . . . . . . . . . . . . . . 524 4.6.2.8 ompt_flush_trace_t . . . . . . . . . . . . . . . . . . . . . . . . 525 4.6.2.9 ompt_stop_trace_t . . . . . . . . . . . . . . . . . . . . . . . . . 526 4.6.2.10 ompt_advance_buffer_cursor_t . . . . . . . . . . . . . . . . 527 4.6.2.11 ompt_get_record_type_t . . . . . . . . . . . . . . . . . . . . . 528 4.6.2.12 ompt_get_record_ompt_t . . . . . . . . . . . . . . . . . . . . . 529 4.6.2.13 ompt_get_record_native_t . . . . . . . . . . . . . . . . . . . 530 4.6.2.14 ompt_get_record_abstract_t . . . . . . . . . . . . . . . . . . 531 4.6.3 Lookup Entry Points: ompt_function_lookup_t . . . . . . . . . . . 531 5 OMPD Interface 533 5.1 OMPD Interfaces Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 5.2 Activating an OMPD Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534 5.2.1 Enabling the Runtime for OMPD . . . . . . . . . . . . . . . . . . . . . . . 534 5.2.2 ompd_dll_locations . . . . . . . . . . . . . . . . . . . . . . . . . . 535 5.2.3 ompd_dll_locations_valid . . . . . . . . . . . . . . . . . . . . . . 536 5.3 OMPD Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 5.3.1 Size Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 5.3.2 Wait ID Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 5.3.3 Basic Value Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 5.3.4 Address Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538 5.3.5 Frame Information Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538 5.3.6 System Device Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 5.3.7 Native Thread Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 5.3.8 OMPD Handle Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540 5.3.9 OMPD Scope Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 5.3.10 ICV ID Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 xii OpenMP API – Version 5.0 November 2018

5.3.11 Tool Context Types 542 5.3.12 Return Code Types. 。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。 543 5.3.13 Primitive Type Sizes 544 5.4 OMPD Tool Callback Interface 545 5.4.1 Memory Management of OMPD Library.. 545 5.4.1.1 ompd_callback_memory_alloc_fn_t.............. 546 5.4.1.2 ompd_callback_memory_free_fn_t............... 546 5.4.2 Context Management and Navigation.···· 547 5.4.2.1 ompd_callback_get_thread_context_for_thread_id fnt.· 547 5.4.2.2 ompd_callback_sizeof_fn_t... 549 5.4.3 Accessing Memory in the OpenMP Program or Runtime.·········· 549 5.4.3.1 ompd_callback_symbol_addr_fn_t. 550 5.4.3.2 ompd_callback_memory_read_fn_t............... 551 5.433 ompd_callback_memory_write_fn_t 53 5.4.4 Data Format Conversion:ompd_callback_device_host_fn_t... 554 5.4.5 Output:ompd_callback_print_string_fn_t............ 556 5.4.6 The Callback Interface.... 556 5.5 OMPD Tool Interface Routines 558 5.5.1 Per OMPD Library Initialization and Finalization 558 5.5.1.1 ompd_initialize 558 5.5.1.2 ompd_get_api_version 559 5.5.13 ompd_get_version_string 560 5.5.1.4 ompd_finalize 。。。。。 561 5.5.2 Per OpenMP Process Initialization and Finalization 562 5.5.2.1 ompd_process_initialize 562 5.5.2.2 ompd_device_initialize 563 5.5.2.3 ompd_rel_address_space_handle 。。。。。。。。。。。。。。。 564 5.5.3 Thread and Signal Safety........................... 565 5.5.4 Address Space Information ......................... 565 5.5.4.1 ompd_get_omp_version....................... 565 5.5.4.2 ompd_get_omp_version_string 566 Contents xciii

5.3.11 Tool Context Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 5.3.12 Return Code Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 5.3.13 Primitive Type Sizes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544 5.4 OMPD Tool Callback Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 5.4.1 Memory Management of OMPD Library . . . . . . . . . . . . . . . . . . . 545 5.4.1.1 ompd_callback_memory_alloc_fn_t . . . . . . . . . . . . . . 546 5.4.1.2 ompd_callback_memory_free_fn_t . . . . . . . . . . . . . . . 546 5.4.2 Context Management and Navigation . . . . . . . . . . . . . . . . . . . . . 547 5.4.2.1 ompd_callback_get_thread_context_for_thread_id _fn_t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 5.4.2.2 ompd_callback_sizeof_fn_t . . . . . . . . . . . . . . . . . . . 549 5.4.3 Accessing Memory in the OpenMP Program or Runtime . . . . . . . . . . . 549 5.4.3.1 ompd_callback_symbol_addr_fn_t . . . . . . . . . . . . . . . 550 5.4.3.2 ompd_callback_memory_read_fn_t . . . . . . . . . . . . . . . 551 5.4.3.3 ompd_callback_memory_write_fn_t . . . . . . . . . . . . . . 553 5.4.4 Data Format Conversion: ompd_callback_device_host_fn_t . . . 554 5.4.5 Output: ompd_callback_print_string_fn_t . . . . . . . . . . . . 556 5.4.6 The Callback Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 5.5 OMPD Tool Interface Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . 558 5.5.1 Per OMPD Library Initialization and Finalization . . . . . . . . . . . . . . 558 5.5.1.1 ompd_initialize . . . . . . . . . . . . . . . . . . . . . . . . . . . 558 5.5.1.2 ompd_get_api_version . . . . . . . . . . . . . . . . . . . . . . . 559 5.5.1.3 ompd_get_version_string . . . . . . . . . . . . . . . . . . . . 560 5.5.1.4 ompd_finalize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 5.5.2 Per OpenMP Process Initialization and Finalization . . . . . . . . . . . . . 562 5.5.2.1 ompd_process_initialize . . . . . . . . . . . . . . . . . . . . 562 5.5.2.2 ompd_device_initialize . . . . . . . . . . . . . . . . . . . . . 563 5.5.2.3 ompd_rel_address_space_handle . . . . . . . . . . . . . . . 564 5.5.3 Thread and Signal Safety . . . . . . . . . . . . . . . . . . . . . . . . . . . 565 5.5.4 Address Space Information . . . . . . . . . . . . . . . . . . . . . . . . . . 565 5.5.4.1 ompd_get_omp_version . . . . . . . . . . . . . . . . . . . . . . . 565 5.5.4.2 ompd_get_omp_version_string . . . . . . . . . . . . . . . . . 566 Contents xiii

5.5.5 Thread Handles..··········· 567 5.5.5.1 ompd_get_thread_in_parallel 567 5.5.5.2 ompd_get_thread handle 568 5.5.5.3 ompd_rel_thread_handle 569 5.5.5.4 ompd_thread_handle_compare 570 5.5.5.5 ompd_get_thread_id 570 5.5.6 Parallel Region Handles 571 5.5.6.1 ompd_get_curr_parallel_handle 571 5.5.6.2 ompd_get_enclosing_parallel_handle 572 5.5.6.3 ompd_get_task_parallel_handle 573 5.5.6.4 ompd_rel_parallel_handle 574 5.5.6.5 ompd_parallel_handle_compare 575 5.5.7 Task Handles. 576 5.5.7.1 ompd_get_curr_task_handle 576 5.5.7.2 ompd_get_generatingtask_handle 577 5.5.7.3 ompd_get_scheduling_task_handle.............. 578 5.5.7.4 ompd_get_task_in_parallel 579 5.5.7.5 ompd_rel_task_handle.... 580 5.5.7.6 ompd_task_handle_compare 580 5.5.7.7 ompd_get_task_function 581 5.5.7.8 ompd_get_task_frame··.. 582 5.5.7.9 ompd enumerate states..... 583 5.5.7.10 ompd_get_state 585 5.5.8 Display Control Variables 586 5.5.8.1 ompd_get_display_control_vars 586 5.5.8.2 ompd_rel_display_control_vars 。。。。。。。。。 587 5.5.9 Accessing Scope-Specific Information 588 5.5.9.1 ompd_enumerate_icvs ...................... 588 5.5.9.2 ompd_get_icv_from_scope 590 5.5.9.3 ompd_get_icv_string_from_scope 591 5.5.9.4 ompd_get_tool_data 592 5.6 Runtime Entry Points for OMPD····.···.················ 594 5.6.1 Beginning Parallel Regions 594 OpenMP API-Version 5.0 November 2018

5.5.5 Thread Handles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567 5.5.5.1 ompd_get_thread_in_parallel . . . . . . . . . . . . . . . . . 567 5.5.5.2 ompd_get_thread_handle . . . . . . . . . . . . . . . . . . . . . 568 5.5.5.3 ompd_rel_thread_handle . . . . . . . . . . . . . . . . . . . . . 569 5.5.5.4 ompd_thread_handle_compare . . . . . . . . . . . . . . . . . . 570 5.5.5.5 ompd_get_thread_id . . . . . . . . . . . . . . . . . . . . . . . . 570 5.5.6 Parallel Region Handles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571 5.5.6.1 ompd_get_curr_parallel_handle . . . . . . . . . . . . . . . 571 5.5.6.2 ompd_get_enclosing_parallel_handle . . . . . . . . . . . 572 5.5.6.3 ompd_get_task_parallel_handle . . . . . . . . . . . . . . . 573 5.5.6.4 ompd_rel_parallel_handle . . . . . . . . . . . . . . . . . . . 574 5.5.6.5 ompd_parallel_handle_compare . . . . . . . . . . . . . . . . 575 5.5.7 Task Handles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 5.5.7.1 ompd_get_curr_task_handle . . . . . . . . . . . . . . . . . . . 576 5.5.7.2 ompd_get_generating_task_handle . . . . . . . . . . . . . . 577 5.5.7.3 ompd_get_scheduling_task_handle . . . . . . . . . . . . . . 578 5.5.7.4 ompd_get_task_in_parallel . . . . . . . . . . . . . . . . . . . 579 5.5.7.5 ompd_rel_task_handle . . . . . . . . . . . . . . . . . . . . . . . 580 5.5.7.6 ompd_task_handle_compare . . . . . . . . . . . . . . . . . . . 580 5.5.7.7 ompd_get_task_function . . . . . . . . . . . . . . . . . . . . . 581 5.5.7.8 ompd_get_task_frame . . . . . . . . . . . . . . . . . . . . . . . 582 5.5.7.9 ompd_enumerate_states . . . . . . . . . . . . . . . . . . . . . . 583 5.5.7.10 ompd_get_state . . . . . . . . . . . . . . . . . . . . . . . . . . . 585 5.5.8 Display Control Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . 586 5.5.8.1 ompd_get_display_control_vars . . . . . . . . . . . . . . . 586 5.5.8.2 ompd_rel_display_control_vars . . . . . . . . . . . . . . . 587 5.5.9 Accessing Scope-Specific Information . . . . . . . . . . . . . . . . . . . . 588 5.5.9.1 ompd_enumerate_icvs . . . . . . . . . . . . . . . . . . . . . . . 588 5.5.9.2 ompd_get_icv_from_scope . . . . . . . . . . . . . . . . . . . . 590 5.5.9.3 ompd_get_icv_string_from_scope . . . . . . . . . . . . . . . 591 5.5.9.4 ompd_get_tool_data . . . . . . . . . . . . . . . . . . . . . . . . 592 5.6 Runtime Entry Points for OMPD . . . . . . . . . . . . . . . . . . . . . . . . . . 594 5.6.1 Beginning Parallel Regions . . . . . . . . . . . . . . . . . . . . . . . . . . 594 xiv OpenMP API – Version 5.0 November 2018