Magic Trace Versions Save

What's Changed

• Fix -trigger addr:... selections by @Xyene in https://github.com/janestreet/magic-trace/pull/289
• Do not display extremely long commandline arguments by @Xyene in https://github.com/janestreet/magic-trace/pull/290
• Handle tr end async trace events by @Xyene in https://github.com/janestreet/magic-trace/pull/288
• make it possible to invoke magic-trace run -- prog args by @v-gb in https://github.com/janestreet/magic-trace/pull/292
• Upgrade to OCaml 4.14.0 by @Xyene in https://github.com/janestreet/magic-trace/pull/294
• Don't assume perf is still alive after sending it SIGTERM by @Xyene in https://github.com/janestreet/magic-trace/pull/293
• Restore default SIGINT behavior after taking snapshot by @Xyene in https://github.com/janestreet/magic-trace/pull/295
• Be more robust to seeing a poptrap without a matching pushtrap by @Xyene in https://github.com/janestreet/magic-trace/pull/296

New Contributors

• @v-gb made their first contribution in https://github.com/janestreet/magic-trace/pull/292

Full Changelog: https://github.com/janestreet/magic-trace/compare/v1.2.0...v1.2.1

What's Changed

• Display DSO if symbol is unknown by @Xyene in https://github.com/janestreet/magic-trace/pull/209
• Added capability to attach to multiple PIDs for tracing by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/218
• Added ability to trace CPU frequencies with perf by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/219
• Add protocol to URLs embedded in help text by @shoffmeister in https://github.com/janestreet/magic-trace/pull/220
• Allow running with sampling if Intel PT is unavailable by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/224
• Improved speed of hex parsing in more places by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/227
• Added comment explaining callstack order of Sample event by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/229
• Filter trace to range by @pbaumbacher in https://github.com/janestreet/magic-trace/pull/222
• Added support to run perf with dlfilter which filters out jumps within same function by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/231
• Added env var to forcibly disable perf dlfilter by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/232
• Allow extra spacing in cbr regex to not crash on some perf outputs by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/235
• Added warnings to -callgraph-mode and added option for stitched LBR. by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/228
• Fixed regex bug in CBR event when flags includes space by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/239
• Updated -trigger help to specify triggers only apply to first PID passed by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/238
• Disable dlfilter when printing trace to sexp by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/240
• Add support for magic-trace to sample and show other events such as cache misses and branch misses by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/234
• Added ability to fuzzy find on line number based triggers by @Lamoreauxaj in https://github.com/janestreet/magic-trace/pull/245
• .ocamlformat: 0.21 -> 0.24.1 by @hlian in https://github.com/janestreet/magic-trace/pull/244
• .github/workflows/build.yml: download upx 3.96-2 from ftp.debian.org by @hlian in https://github.com/janestreet/magic-trace/pull/252
• Demangle OCaml symbols by @ClyveGassant in https://github.com/janestreet/magic-trace/pull/250
• Add separate events output in sexp or binio format by @Istlemin in https://github.com/janestreet/magic-trace/pull/253
• Disable dlfilter by default by @cgaebel in https://github.com/janestreet/magic-trace/pull/255
• Unwind the stack for caml_stash_backtrace by @cgaebel in https://github.com/janestreet/magic-trace/pull/262
• Fix dlfilter filtering out trace errors by @Xyene in https://github.com/janestreet/magic-trace/pull/265
• Only check for fzf if required to find symbol by @ecatmur in https://github.com/janestreet/magic-trace/pull/277
• Add explicit tests around bogus symbol offset handling by @Xyene in https://github.com/janestreet/magic-trace/pull/279
• Fix stairstepping OCaml traces when exceptions are involved by @Xyene in https://github.com/janestreet/magic-trace/pull/280
• Miscellaneous changes ahead of 1.2 by @Xyene in https://github.com/janestreet/magic-trace/pull/281
• Fix up some messages about sampling wiki links by @Xyene in https://github.com/janestreet/magic-trace/pull/282

New Contributors

• @shoffmeister made their first contribution in https://github.com/janestreet/magic-trace/pull/220
• @pbaumbacher made their first contribution in https://github.com/janestreet/magic-trace/pull/222
• @hlian made their first contribution in https://github.com/janestreet/magic-trace/pull/244
• @ClyveGassant made their first contribution in https://github.com/janestreet/magic-trace/pull/250
• @Istlemin made their first contribution in https://github.com/janestreet/magic-trace/pull/253
• @ecatmur made their first contribution in https://github.com/janestreet/magic-trace/pull/277

Full Changelog: https://github.com/janestreet/magic-trace/compare/v1.1.0...v1.2.0

What's Changed

• Proper OCaml exception tracking by @Xyene in https://github.com/janestreet/magic-trace/pull/204
• Add Go-specific hacks to fix demo.go by @cgaebel in https://github.com/janestreet/magic-trace/pull/197
• Fix parsing of never-ending loop trace errors by @Xyene in https://github.com/janestreet/magic-trace/pull/203
• Gracefully handle owee failures in Elf.addr_table by @cgaebel in https://github.com/janestreet/magic-trace/pull/195
• Allow saving raw IPT data to .sexp format, bypassing .fxt generation by @Xyene in https://github.com/janestreet/magic-trace/pull/208
• Give a good error message when waitpid raises by @cgaebel in https://github.com/janestreet/magic-trace/pull/211

New Contributors

• @RobbertH made their first contribution in https://github.com/janestreet/magic-trace/pull/198

Full Changelog: https://github.com/janestreet/magic-trace/compare/v1.0.2...v1.1.0

What's Changed

• Fix debian package build by @quantum5 in https://github.com/janestreet/magic-trace/pull/186
• Improve checks for fzf and perf by @cgaebel in https://github.com/janestreet/magic-trace/pull/188

Full Changelog: https://github.com/janestreet/magic-trace/compare/v1.0.1...v1.0.2

To install, download magic-trace below, run chmod +x magic-trace, then run ./magic-trace -help.

This release contains a lot of improvements and bugfixes to magic-trace. Upgrading is highly recommended.

The full changelog is available here.

Statically-linked executables and Ubuntu 20.04-equivalent-or-newer packages are attached to this release.

Features

• The snapshot buffer size is now configurable
• Timing granularity is now configurable, with lower granularities having lower recording overhead

Fixes

• Fixed the class of broken traces caused by ignoring Intel PT decode errors
• Gracefully handle duplicate entries in perf map files
• Propagate errors from perf
• Kernel threads are no longer shown when running as root, since they can't currently be traced
• perf now unconditionally exits when magic-trace does, rather than occasionally outliving it
• Fixed decoding failure when -working-dir is a relative path

Miscellaneous

• Sped up trace decoding
• --version now displays git version information
• Command help text now contains example invocations
• Default trace file is now trace.fxt (used to be trace.ftf); this is the correct file extension for Fuchsia traces
• Many refactors under the hood to permit more unit testing

This release contains a lot of improvements and bugfixes to magic-trace. Upgrading is highly recommended.

The full changelog is available here.

Statically-linked executables and Ubuntu 20.04-equivalent-or-newer packages are attached to this release.

Features

• Add support for managed languages (reading of perf map files for symbol selection)
• Add support for tracing the kernel
• Add support for executables compiled with basic DWARF 5 debug info
• Embed absolute timestamps in trace, so that they appear in the viewer and can be matched to logged events
• Report which frames had their start time inferred
• Mark addresses as pointers in the Fuchsia trace, so they show up as hexadecimal in the viewer

Fixes

• Make fzf an optional runtime dependency, rather than crash if it doesn't exist
• Fixed perf output parsing for symbols including =

Miscellaneous

• Default to trace.ftf as the output file, moving an existing trace.ftf to trace.ftf.old
• Cleaned up the command line interface

This minor release contains largely groundwork for setting up a more regular release cycle.

The full changelog is available here.

Binaries for Ubuntu 20.04-equivalent-or-newer systems are included, as are packages. The next release will have statically-linked executables available for download.

Features

• Symbol name and post-relocation hex addresses are now printed when specifying -symbol
• Decoding C++ symbols is now supported

Fixes

• fzf will now be started from anywhere in $PATH, not just /usr/bin/fzf