Files
TheRock/rocm-systems/projects/rocprofiler-systems/external/dyninst/dynC_API/doc/A-TheDyninstDomain.tex
T
derek.holloway 7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
Flatten subprojects into a single base monorepo
2026-09-02 16:34:47 -07:00

44 lines
1.8 KiB
TeX

\appendix
\section{The Dyninst Domain}
\label{sec:dyninstdomain}
The \code{dyninst} domain has quite a few useful values and functions:
\begin{table}[!th]
\begin{tabular}{ | l | l | p{4cm} | p{6.5cm} |}
\hline
Identifier & Type & Where Valid & Description\\
\hline
\code{function\_name} & \code{char *} & Within a function & Evaluates to the
name of the current function. Call to \code{createSnippet(...)} must specify a
\code{BPatch\_point}.\\
\hline
\code{module\_name} & \code{char *} & Anywhere & Evaluates to the name of the
current module. Call to \code{createSnippet(...)} must specify a \code{BPatch\_point}.\\
\hline
\code{bytes\_accessed} & int & At a memory operation & Evaluates to the number of bytes accessed by a memory operation.\\
\hline
\code{effective\_address} & \code{void *} & At a memory operation & Evaluates the effective address of a memory operation.\\
\hline
\code{original\_address} & \code{void *} & Anywhere & Evaluates to the original address where the snippet was inserted. \\
\hline
\code{actual\_address} & \code{void *} & Anywhere & Evaluates to the actual address of the instrumentation. \\
\hline
\code{return\_value} & \code{void *} & Function exit & Evaluates to the return value of a function.\\
\hline
\code{thread\_index} & int & Anywhere & Returns the index of the thread the snippet is executing on.\\
\hline
\code{tid} & int & Anywhere & Returns the id of the thread the snippet is executing on.\\
\hline
\code{dynamic\_target} & \code{void *} & At calls, jumps, returns & Calculates the target of a control flow instruction.\\
\hline
\code{break()} & void & Anywhere & Causes the mutatee to execute a breakpoint.\\
\hline
\code{stopthread()} & void & Anywhere & Stops the thread on which the snippet is executing.\\
\hline
\end{tabular}
\caption{Dyninst Domain Values}
\end{table}