qwwdfsad / homebrew-tap Goto Github PK

Small Homebrew tap for Java-related profiling tools.

Usage:

brew tap qwwdfsad/tap
brew install async-profiler
brew install hsdis

Formula for the binary installation of async-profiler that adds asprof to the corresponding */bin/* and provides a convenience wrapper over converter.jar.

Installation:

brew tap qwwdfsad/tap
brew install async-profiler

Usage:

asprof -f profile.html -d 20 <pid|JPS name>
asprof-converter jfr2flame --bci profile.jfr profile.html

Additionaly, formula installs libasyncProfiler.dylib into Homebrew prefix ($HOMEBREW_PREFIX/lib/) for the easier discovery.

To further use async-profiler with JMH's -prof async seamlessly, consider adding the installed dylib into DYLD_LIBRARY_PATH. The brew installation will hint you on that.

Formula for the installation of hsdis -- Hotspot disassembly library for Java:

brew tap qwwdfsad/tap
brew install hsdis

The formula builds it from OpenJDK sources against Capstone with the effortless-hsdis and installs the hsdis dylib into Homebrew keg.

The installer will give you a hint what to do next:

hsdis was installed into /opt/homebrew/opt/hsdis/libexec/lib/hsdis-aarch64.dylib
In order to make it locateable by the JVM, you can either add it to Java's lib folder ($JAVA_HOME/lib/)
or add a lib path to the $DYLD_LIBRARY_PATH:
$ echo 'export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:/opt/homebrew/opt/hsdis/libexec/lib/' >> ~/.zshrc