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
27 lines
1.7 KiB
TeX
27 lines
1.7 KiB
TeX
\section{Introduction}
|
|
\label{sec:intro}
|
|
|
|
A binary code parser converts the machine code representation of a program,
|
|
library, or code snippet to abstractions such as the instructions, basic
|
|
blocks, functions, and loops that the binary code represents. The ParseAPI is a
|
|
multi-platform library for creating such abstractions from binary code sources.
|
|
The current incarnation uses the Dyninst SymtabAPI as the default binary code
|
|
source; all platforms and architectures handled by the SymtabAPI are supported.
|
|
The ParseAPI has cross-architecture binary analysis capabilities in analyzing
|
|
ELF binaries (parsing of ARM binaries on x86 and vice versa, for example).
|
|
The ParseAPI is designed to be easily extensible to other binary code sources.
|
|
Support for parsing binary code in memory dumps or other formats requires only
|
|
implementation of a small interface as described in this document.
|
|
|
|
This API provides the user with a control flow-oriented view of a binary code
|
|
source. Each code object such as a program binary or library is represented as
|
|
a top-level collection containing the loops, functions, basic blocks, and edges that
|
|
represent the control flow graph. A simple query interface is provided for
|
|
retrieving lower level objects like functions and basic blocks through address
|
|
or other attribute lookups. These objects can be used to navigate the program
|
|
structure as described below.
|
|
|
|
Since Dyninst 10.0, ParseAPI is officially supporting parallel binary code analysis
|
|
and parallel queries. We typically observe 4X speedup when analyzing binaries with
|
|
8 threads. To control the number of threads used during parallel parsing, please
|
|
set environment variable \code{OMP\_NUM\_THREADS}. |