Info commands

The info functions command displays the list of functions in the debugged program.

Syntax

info functions
info functions [Regex]

Note

Running the info functions command without arguments may produce a lot of output as the list of all functions in all loaded shared libraries is typically very long.

Parameters

Regex

If the regex is specified, the info functions command lists the functions matching the regex. If omitted, the command lists all functions in all loaded modules (main program and shared libraries).

Consider Numba-dppy kernel code. See the source file numba_dppy/examples/debug/simple_sum.py:

import dpctl
import numpy as np

import numba_dppy as dppy


@dppy.kernel(debug=True)
def data_parallel_sum(a, b, c):
    i = dppy.get_global_id(0)
    c[i] = a[i] + b[i]


global_size = 10
N = global_size

a = np.array(np.random.random(N), dtype=np.float32)
b = np.array(np.random.random(N), dtype=np.float32)
c = np.ones_like(a)

device = dpctl.SyclDevice("opencl:gpu")
with dppy.offload_to_sycl_device(device):
    data_parallel_sum[global_size, dppy.DEFAULT_LOCAL_SIZE](a, b, c)

print("Done...")

Run the debugger and use the info functions command. The output is as follows:

$ NUMBA_OPT=0 gdb-oneapi -q python
(gdb) set breakpoint pending on
(gdb) break simple_sum.py:22
(gdb) run simple_sum.py
(gdb) info functions data_parallel_sum
...
All functions matching regular expression "data_parallel_sum":
File simple_sum.py:
20:         void __main__::data_parallel_sum(DPPYArray<float, 1, C, mutable, aligned>, DPPYArray<float, 1, C, mutable, aligned>, DPPYArray<float, 1, C, mutable, aligned>);
(gdb) continue
(gdb) info functions __main__
...
All functions matching regular expression "__main__":
20:         void __main__::data_parallel_sum(DPPYArray<float, 1, C, mutable, aligned>, DPPYArray<float, 1, C, mutable, aligned>, DPPYArray<float, 1, C, mutable, aligned>);
(gdb) continue
...
Done...