llvm-project/openmp/libompd/gdb-plugin/ompd/ompd_address_space.py
Tobias Hieta f98ee40f4b
[NFC][Py Reformat] Reformat python files in the rest of the dirs
This is an ongoing series of commits that are reformatting our
Python code. This catches the last of the python files to
reformat. Since they where so few I bunched them together.

Reformatting is done with `black`.

If you end up having problems merging this commit because you
have made changes to a python file, the best way to handle that
is to run git checkout --ours <yourfile> and then reformat it
with black.

If you run into any problems, post to discourse about it and
we will try to help.

RFC Thread below:

https://discourse.llvm.org/t/rfc-document-and-standardize-python-code-style

Reviewed By: jhenderson, #libc, Mordante, sivachandra

Differential Revision: https://reviews.llvm.org/D150784
2023-05-25 11:17:05 +02:00

470 lines
20 KiB
Python

from __future__ import print_function
import ompdModule
from ompd_handles import ompd_thread, ompd_task, ompd_parallel
import gdb
import sys
import traceback
from enum import Enum
class ompd_scope(Enum):
ompd_scope_global = 1
ompd_scope_address_space = 2
ompd_scope_thread = 3
ompd_scope_parallel = 4
ompd_scope_implicit_task = 5
ompd_scope_task = 6
class ompd_address_space(object):
def __init__(self):
"""Initializes an ompd_address_space object by calling ompd_initialize
in ompdModule.c
"""
self.addr_space = ompdModule.call_ompd_initialize()
# maps thread_num (thread id given by gdb) to ompd_thread object with thread handle
self.threads = {}
self.states = None
self.icv_map = None
self.ompd_tool_test_bp = None
self.scope_map = {
1: "global",
2: "address_space",
3: "thread",
4: "parallel",
5: "implicit_task",
6: "task",
}
self.sched_map = {1: "static", 2: "dynamic", 3: "guided", 4: "auto"}
gdb.events.stop.connect(self.handle_stop_event)
self.new_thread_breakpoint = gdb.Breakpoint(
"ompd_bp_thread_begin", internal=True
)
tool_break_symbol = gdb.lookup_global_symbol("ompd_tool_break")
if tool_break_symbol is not None:
self.ompd_tool_test_bp = gdb.Breakpoint("ompd_tool_break", internal=True)
def handle_stop_event(self, event):
"""Sets a breakpoint at different events, e.g. when a new OpenMP
thread is created.
"""
if isinstance(event, gdb.BreakpointEvent):
# check if breakpoint has already been hit
if self.new_thread_breakpoint in event.breakpoints:
self.add_thread()
gdb.execute("continue")
return
elif (
self.ompd_tool_test_bp is not None
and self.ompd_tool_test_bp in event.breakpoints
):
try:
self.compare_ompt_data()
gdb.execute("continue")
except ():
traceback.print_exc()
elif isinstance(event, gdb.SignalEvent):
# TODO: what do we need to do on SIGNALS?
pass
else:
# TODO: probably not possible?
pass
def get_icv_map(self):
"""Fills ICV map."""
self.icv_map = {}
current = 0
more = 1
while more > 0:
tup = ompdModule.call_ompd_enumerate_icvs(self.addr_space, current)
(current, next_icv, next_scope, more) = tup
self.icv_map[next_icv] = (current, next_scope, self.scope_map[next_scope])
print("Initialized ICV map successfully for checking OMP API values.")
def compare_ompt_data(self):
"""Compares OMPT tool data about parallel region to data returned by OMPD functions."""
# make sure all threads and states are set
self.list_threads(False)
thread_id = gdb.selected_thread().ptid[1]
curr_thread = self.get_curr_thread()
# check if current thread is LWP thread; return if "ompd_rc_unavailable"
thread_handle = ompdModule.get_thread_handle(thread_id, self.addr_space)
if thread_handle == -1:
print("Skipping OMPT-OMPD checks for non-LWP thread.")
return
print("Comparing OMPT data to OMPD data...")
field_names = [i.name for i in gdb.parse_and_eval("thread_data").type.fields()]
thread_data = gdb.parse_and_eval("thread_data")
if self.icv_map is None:
self.get_icv_map()
# compare state values
if "ompt_state" in field_names:
if self.states is None:
self.enumerate_states()
ompt_state = str(thread_data["ompt_state"])
ompd_state = str(self.states[curr_thread.get_state()[0]])
if ompt_state != ompd_state:
print(
"OMPT-OMPD mismatch: ompt_state (%s) does not match OMPD state (%s)!"
% (ompt_state, ompd_state)
)
# compare wait_id values
if "ompt_wait_id" in field_names:
ompt_wait_id = thread_data["ompt_wait_id"]
ompd_wait_id = curr_thread.get_state()[1]
if ompt_wait_id != ompd_wait_id:
print(
"OMPT-OMPD mismatch: ompt_wait_id (%d) does not match OMPD wait id (%d)!"
% (ompt_wait_id, ompd_wait_id)
)
# compare thread id
if "omp_thread_num" in field_names and "thread-num-var" in self.icv_map:
ompt_thread_num = thread_data["omp_thread_num"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.thread_handle,
self.icv_map["thread-num-var"][1],
self.icv_map["thread-num-var"][0],
)
if ompt_thread_num != icv_value:
print(
"OMPT-OMPD mismatch: omp_thread_num (%d) does not match OMPD thread num according to ICVs (%d)!"
% (ompt_thread_num, icv_value)
)
# compare thread data
if "ompt_thread_data" in field_names:
ompt_thread_data = thread_data["ompt_thread_data"].dereference()["value"]
ompd_value = ompdModule.call_ompd_get_tool_data(
3, curr_thread.thread_handle
)[0]
if ompt_thread_data != ompd_value:
print(
"OMPT-OMPD mismatch: value of ompt_thread_data (%d) does not match that of OMPD data union (%d)!"
% (ompt_thread_data, ompd_value)
)
# compare number of threads
if "omp_num_threads" in field_names and "team-size-var" in self.icv_map:
ompt_num_threads = thread_data["omp_num_threads"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_parallel_handle(),
self.icv_map["team-size-var"][1],
self.icv_map["team-size-var"][0],
)
if ompt_num_threads != icv_value:
print(
"OMPT-OMPD mismatch: omp_num_threads (%d) does not match OMPD num threads according to ICVs (%d)!"
% (ompt_num_threads, icv_value)
)
# compare omp level
if "omp_level" in field_names and "levels-var" in self.icv_map:
ompt_levels = thread_data["omp_level"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_parallel_handle(),
self.icv_map["levels-var"][1],
self.icv_map["levels-var"][0],
)
if ompt_levels != icv_value:
print(
"OMPT-OMPD mismatch: omp_level (%d) does not match OMPD levels according to ICVs (%d)!"
% (ompt_levels, icv_value)
)
# compare active level
if "omp_active_level" in field_names and "active-levels-var" in self.icv_map:
ompt_active_levels = thread_data["omp_active_level"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_parallel_handle(),
self.icv_map["active-levels-var"][1],
self.icv_map["active-levels-var"][0],
)
if ompt_active_levels != icv_value:
print(
"OMPT-OMPD mismatch: active levels (%d) do not match active levels according to ICVs (%d)!"
% (ompt_active_levels, icv_value)
)
# compare parallel data
if "ompt_parallel_data" in field_names:
ompt_parallel_data = thread_data["ompt_parallel_data"].dereference()[
"value"
]
current_parallel_handle = curr_thread.get_current_parallel_handle()
ompd_value = ompdModule.call_ompd_get_tool_data(4, current_parallel_handle)[
0
]
if ompt_parallel_data != ompd_value:
print(
"OMPT-OMPD mismatch: value of ompt_parallel_data (%d) does not match that of OMPD data union (%d)!"
% (ompt_parallel_data, ompd_value)
)
# compare max threads
if "omp_max_threads" in field_names and "nthreads-var" in self.icv_map:
ompt_max_threads = thread_data["omp_max_threads"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.thread_handle,
self.icv_map["nthreads-var"][1],
self.icv_map["nthreads-var"][0],
)
if icv_value is None:
icv_string = ompdModule.call_ompd_get_icv_string_from_scope(
curr_thread.thread_handle,
self.icv_map["nthreads-var"][1],
self.icv_map["nthreads-var"][0],
)
if icv_string is None:
print(
"OMPT-OMPD mismatch: omp_max_threads (%d) does not match OMPD thread limit according to ICVs (None Object)"
% (ompt_max_threads)
)
else:
if ompt_max_threads != int(icv_string.split(",")[0]):
print(
"OMPT-OMPD mismatch: omp_max_threads (%d) does not match OMPD thread limit according to ICVs (%d)!"
% (ompt_max_threads, int(icv_string.split(",")[0]))
)
else:
if ompt_max_threads != icv_value:
print(
"OMPT-OMPD mismatch: omp_max_threads (%d) does not match OMPD thread limit according to ICVs (%d)!"
% (ompt_max_threads, icv_value)
)
# compare omp_parallel
# NOTE: omp_parallel = true if active-levels-var > 0
if "omp_parallel" in field_names:
ompt_parallel = thread_data["omp_parallel"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_parallel_handle(),
self.icv_map["active-levels-var"][1],
self.icv_map["active-levels-var"][0],
)
if (
ompt_parallel == 1
and icv_value <= 0
or ompt_parallel == 0
and icv_value > 0
):
print(
"OMPT-OMPD mismatch: ompt_parallel (%d) does not match OMPD parallel according to ICVs (%d)!"
% (ompt_parallel, icv_value)
)
# compare omp_final
if "omp_final" in field_names and "final-task-var" in self.icv_map:
ompt_final = thread_data["omp_final"]
current_task_handle = curr_thread.get_current_task_handle()
icv_value = ompdModule.call_ompd_get_icv_from_scope(
current_task_handle,
self.icv_map["final-task-var"][1],
self.icv_map["final-task-var"][0],
)
if icv_value != ompt_final:
print(
"OMPT-OMPD mismatch: omp_final (%d) does not match OMPD final according to ICVs (%d)!"
% (ompt_final, icv_value)
)
# compare omp_dynamic
if "omp_dynamic" in field_names and "dyn-var" in self.icv_map:
ompt_dynamic = thread_data["omp_dynamic"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.thread_handle,
self.icv_map["dyn-var"][1],
self.icv_map["dyn-var"][0],
)
if icv_value != ompt_dynamic:
print(
"OMPT-OMPD mismatch: omp_dynamic (%d) does not match OMPD dynamic according to ICVs (%d)!"
% (ompt_dynamic, icv_value)
)
# compare omp_max_active_levels
if (
"omp_max_active_levels" in field_names
and "max-active-levels-var" in self.icv_map
):
ompt_max_active_levels = thread_data["omp_max_active_levels"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_task_handle(),
self.icv_map["max-active-levels-var"][1],
self.icv_map["max-active-levels-var"][0],
)
if ompt_max_active_levels != icv_value:
print(
"OMPT-OMPD mismatch: omp_max_active_levels (%d) does not match OMPD max active levels (%d)!"
% (ompt_max_active_levels, icv_value)
)
# compare omp_kind: TODO: Add the test for monotonic/nonmonotonic modifier
if "omp_kind" in field_names and "run-sched-var" in self.icv_map:
ompt_sched_kind = thread_data["omp_kind"]
icv_value = ompdModule.call_ompd_get_icv_string_from_scope(
curr_thread.get_current_task_handle(),
self.icv_map["run-sched-var"][1],
self.icv_map["run-sched-var"][0],
)
ompd_sched_kind = icv_value.split(",")[0]
if self.sched_map.get(int(ompt_sched_kind)) != ompd_sched_kind:
print(
"OMPT-OMPD mismatch: omp_kind kind (%s) does not match OMPD schedule kind according to ICVs (%s)!"
% (self.sched_map.get(int(ompt_sched_kind)), ompd_sched_kind)
)
# compare omp_modifier
if "omp_modifier" in field_names and "run-sched-var" in self.icv_map:
ompt_sched_mod = thread_data["omp_modifier"]
icv_value = ompdModule.call_ompd_get_icv_string_from_scope(
curr_thread.get_current_task_handle(),
self.icv_map["run-sched-var"][1],
self.icv_map["run-sched-var"][0],
)
token = icv_value.split(",")[1]
if token is not None:
ompd_sched_mod = int(token)
else:
ompd_sched_mod = 0
if ompt_sched_mod != ompd_sched_mod:
print(
"OMPT-OMPD mismatch: omp_kind modifier does not match OMPD schedule modifier according to ICVs!"
)
# compare omp_proc_bind
if "omp_proc_bind" in field_names and "bind-var" in self.icv_map:
ompt_proc_bind = thread_data["omp_proc_bind"]
icv_value = ompdModule.call_ompd_get_icv_from_scope(
curr_thread.get_current_task_handle(),
self.icv_map["bind-var"][1],
self.icv_map["bind-var"][0],
)
if icv_value is None:
icv_string = ompdModule.call_ompd_get_icv_string_from_scope(
curr_thread.get_current_task_handle(),
self.icv_map["bind-var"][1],
self.icv_map["bind-var"][0],
)
if icv_string is None:
print(
"OMPT-OMPD mismatch: omp_proc_bind (%d) does not match OMPD proc bind according to ICVs (None Object)"
% (ompt_proc_bind)
)
else:
if ompt_proc_bind != int(icv_string.split(",")[0]):
print(
"OMPT-OMPD mismatch: omp_proc_bind (%d) does not match OMPD proc bind according to ICVs (%d)!"
% (ompt_proc_bind, int(icv_string.split(",")[0]))
)
else:
if ompt_proc_bind != icv_value:
print(
"OMPT-OMPD mismatch: omp_proc_bind (%d) does not match OMPD proc bind according to ICVs (%d)!"
% (ompt_proc_bind, icv_value)
)
# compare enter and exit frames
if "ompt_frame_list" in field_names:
ompt_task_frame_dict = thread_data["ompt_frame_list"].dereference()
ompt_task_frames = (
int(ompt_task_frame_dict["enter_frame"].cast(gdb.lookup_type("long"))),
int(ompt_task_frame_dict["exit_frame"].cast(gdb.lookup_type("long"))),
)
current_task = curr_thread.get_current_task()
ompd_task_frames = current_task.get_task_frame()
if ompt_task_frames != ompd_task_frames:
print(
"OMPT-OMPD mismatch: ompt_task_frames (%s) do not match OMPD task frames (%s)!"
% (ompt_task_frames, ompd_task_frames)
)
# compare task data
if "ompt_task_data" in field_names:
ompt_task_data = thread_data["ompt_task_data"].dereference()["value"]
current_task_handle = curr_thread.get_current_task_handle()
ompd_value = ompdModule.call_ompd_get_tool_data(6, current_task_handle)[0]
if ompt_task_data != ompd_value:
print(
"OMPT-OMPD mismatch: value of ompt_task_data (%d) does not match that of OMPD data union (%d)!"
% (ompt_task_data, ompd_value)
)
def save_thread_object(self, thread_num, thread_id, addr_space):
"""Saves thread object for thread_num inside threads dictionary."""
thread_handle = ompdModule.get_thread_handle(thread_id, addr_space)
self.threads[int(thread_num)] = ompd_thread(thread_handle)
def get_thread(self, thread_num):
"""Get thread object from map."""
return self.threads[int(thread_num)]
def get_curr_thread(self):
"""Get current thread object from map or add new one to map, if missing."""
thread_num = int(gdb.selected_thread().num)
if thread_num not in self.threads:
self.add_thread()
return self.threads[thread_num]
def add_thread(self):
"""Add currently selected (*) thread to dictionary threads."""
inf_thread = gdb.selected_thread()
try:
self.save_thread_object(inf_thread.num, inf_thread.ptid[1], self.addr_space)
except:
traceback.print_exc()
def list_threads(self, verbose):
"""Prints OpenMP threads only that are being tracking inside the "threads" dictionary.
See handle_stop_event and add_thread.
"""
list_tids = []
curr_inferior = gdb.selected_inferior()
for inf_thread in curr_inferior.threads():
list_tids.append((inf_thread.num, inf_thread.ptid))
if verbose:
if self.states is None:
self.enumerate_states()
for (thread_num, thread_ptid) in sorted(list_tids):
if thread_num in self.threads:
try:
print(
"Thread %i (%i) is an OpenMP thread; state: %s"
% (
thread_num,
thread_ptid[1],
self.states[self.threads[thread_num].get_state()[0]],
)
)
except:
traceback.print_exc()
else:
print(
"Thread %i (%i) is no OpenMP thread"
% (thread_num, thread_ptid[1])
)
def enumerate_states(self):
"""Helper function for list_threads: initializes map of OMPD states for output of
'ompd threads'.
"""
if self.states is None:
self.states = {}
current = int("0x102", 0)
count = 0
more = 1
while more > 0:
tup = ompdModule.call_ompd_enumerate_states(self.addr_space, current)
(next_state, next_state_name, more) = tup
self.states[next_state] = next_state_name
current = next_state