Skip to content

perfr perfr-v0.1.6

Choose a tag to compare

@github-actions github-actions released this 17 Nov 16:49
· 49 commits to main since this release

Rust perfr for Linux, macOS and Windows. The viewer is in the binary; open it in a browser.

Debug info is split out, not deleted: perfr-<version>-<target>-debug.tar.gz and a symbol-store layout in perfr-<version>-<target>-symstore.tar.gz (debuginfod buildid/<id>/debuginfo, SymSrv <name>/<GUIDAGE>/<name>).

Linux x86-64 (perfr-linux-x86_64.tar.gz): static musl binary with the WASM viewer embedded, DWARF removed and a GNU build-id plus .gnu_debuglink left in place. The archive also contains:

  • libperfr.so: the library profiled programs load, for manual instrumentation and as the agent for function hooks
  • include/perfr.h: the C header. Installers place it in /.local/include (the sibling include of PERFR_INSTALL_DIR), not beside the binary. Compile with -I/.local/include. The header loads libperfr from beside perfr on PATH
  • perfr-hook: attaches to a process and loads libperfr into it
  • perfr-gpu (optional NVIDIA lanes; dynamically linked)
  • licenses/ (Frida)

macOS (perfr-macos-universal.tar.gz): universal binary (Apple silicon and Intel), libperfr.dylib, perfr-hook, libperfr_api.a, include/perfr.h, and licenses/. The header is installed to ~/.local/include, same as Linux. Ad-hoc signed, not notarized. Manual scopes and Frida function hooks. Attaching needs a task port. No call-stack sampling, scheduler, live disassembly, or auto-profiling. No GPU helper.

Windows x86-64 (perfr-windows-x86_64.zip): static-CRT binaries. Beside perfr.exe: libperfr.dll (manual instrumentation and the hook agent), perfr-hook.exe, perfr_api.lib and include\perfr.h, PerfrTestRust.exe, licenses/. PDBs are in the debug archive, not this zip. Call-stack sampling, the scheduler and thread states come from the kernel logger (ETW) and need an elevated prompt; manual scopes and Frida hooks do not. No auto-profiling, no kernel hook engine, no GPU helper.

Viewer (perfr-viewer.tar.gz): the viewer built for this tag, the page that shows a capture file with no service behind it. A gzip tar of crates/perfr-viewer/viewer-dist with paths relative to that directory (index.html at the top, plus the wasm glue, .wasm, snippets/ and stories/). perfr-viewer.tar.gz.sha256 is the sha256sum sidecar. perfr.dev hosts this asset.

Client (perfr-client.tar.gz): the page the service serves, the same interface with the service behind it, as it is embedded in the binaries above. Packed the same way from crates/perfr-client/viewer-dist, with its own .sha256.

Checksums: SHA256SUMS and the per-archive .sha256 files.

Install (fails with a clear message until a non-prerelease perfr-v* tag exists):

curl -fsSL https://perfr.dev/install.sh | sh

Windows (PowerShell):

irm https://perfr.dev/install.ps1 | iex

This is not a legacy C++ nightly (nightly-* / v1.*).

Sizes from this run, in bytes:

target=linux-x86_64
core_archive_bytes=14751789
debug_archive_bytes=38813475
symstore_archive_bytes=38815860
core_installed_bytes=44864625
core_file:include/perfr.h=27153
core_file:libperfr.so=3491368
core_file:licenses/frida-core.txt=2416
core_file:licenses/frida-gum.txt=5696
core_file:perfr=25675192
core_file:perfr-gpu=444288
core_file:perfr-hook=15218512
target=macos-universal
core_archive_bytes=44659650
debug_archive_bytes=51326243
symstore_archive_bytes=102631288
core_installed_bytes=117284826
core_file:README.md=2289
core_file:include/perfr.h=27153
core_file:libperfr.dylib=7486816
core_file:libperfr_api.a=36609312
core_file:licenses/frida-core.txt=2416
core_file:licenses/frida-gum.txt=5696
core_file:perfr=45316096
core_file:perfr-hook=27823264
core_file:perfr_api.py=11784
target=windows-x86_64
core_archive_bytes=43090143
debug_archive_bytes=36472876
symstore_archive_bytes=73307536
core_installed_bytes=110588518
core_file:include\perfr.h=27153
core_file:libperfr.dll=3096064
core_file:libperfr.dll.lib=5466
core_file:licenses\frida-core.txt=2466
core_file:licenses\frida-gum.txt=5814
core_file:perfr-hook.exe=67910144
core_file:perfr.exe=22111744
core_file:perfr_api.lib=17054634
core_file:perfr_api.py=11784
core_file:PerfrTestRust.exe=360960
core_file:README.md=2289