dmstack 是一个用于采集和解析进程调用栈的命令行工具。在 Linux 环境下，它可以采集目标进程的线程栈，并结合本地二进制文件或调试符号进行符号解析；同时也支持从已有的栈文本文件中读取内容并重新格式化输出。

• 采集目标进程所有线程的调用栈。
• 基于 libunwind、binutils/bfd 和 elfutils/libelf 解析并符号化栈帧。
• 支持对原始栈文件进行重新格式化、过滤、聚合和紧凑输出。
• 支持优先输出指定线程，并按最小栈深度过滤结果。
• 支持指定二进制文件路径和独立调试符号路径。

• CMake 3.8 或更高版本
• 支持 C++14 的编译器
• GNU Make
• 当前 Linux 版本支持 x86 和 ARM 两种平台

Linux 构建直接使用系统安装的动态库（.so）。需要安装以下开发包：

• binutils
• elfutils
• libunwind

Debian / Ubuntu：

sudo apt-get update
sudo apt-get install -y cmake g++ make binutils-dev libelf-dev libunwind-dev

• CMake 3.8 或更高版本
• Visual Studio C++ 编译工具链，或其他可被 CMake 识别的 C++14 编译器
• Ninja

Windows 目标主要用于通过 --input 读取并格式化已有栈文本。

当前 Linux 支持 x86 和 ARM 两种平台。CMake 会根据当前机器架构选择对应的 libunwind 架构库名称，例如 unwind-x86_64 或 unwind-aarch64。

Debug 构建：

cmake -S . -B build_debug -DCMAKE_BUILD_TYPE=Debug
cmake --build build_debug

Release 构建：

cmake -S . -B build_release -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build_release

生成的可执行文件位于：

build_release/dmstack/dmstack

Windows 可通过 CMake 和 Ninja 直接构建：

cmake -S . -B out/build/x64-release -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build out/build/x64-release

生成的可执行文件位于：

out/build/x64-release/dmstack/dmstack.exe

采集并解析某个进程所有线程的调用栈：

dmstack <pid>

仅采集原始地址，不做符号解析：

dmstack --no-parse <pid>

从文件读取栈内容并重新格式化：

dmstack --input stack.txt

聚合相同的调用栈：

dmstack --aggregate <pid>

使用紧凑输出、隐藏线程 ID，并只输出深度大于 10 的调用栈：

dmstack --format-compact --hide-thread 1 --min-depth 10 <pid>

.
|-- CMakeLists.txt
|-- dmstack/
|   |-- dmstack.cpp
|   |-- config.*
|   |-- bfd/
|   |-- log/
|   |-- unwind/
|   `-- utils/

• Linux 下采集目标进程调用栈时，可能需要具备访问目标进程的权限。

  使用命令授予权限：

  sudo setcap cap_sys_ptrace+ep dmstack
  

• 为获得更完整的符号解析结果，建议提供目标程序的二进制路径和匹配的调试符号。

• Linux 构建使用系统安装的动态库，需要确保 libbfd.so、libiberty、libelf.so、libunwind*.so 可被编译器和动态链接器找到。

本项目使用 GPL-3.0 许可证，详见 LICENSE。