bingzhilanmo-bowen / jattach Goto Github PK

The utility to send commands to remote JVM via Dynamic Attach mechanism.

All-in-one jmap + jstack + jcmd + jinfo functionality in a single tiny program.
No installed JDK required, works with just JRE. Supports Linux containers.

This is the lightweight native version of HotSpot Attach API
https://docs.oracle.com/javase/8/docs/jdk/api/attach/spec/

Supported commands:

• load : load agent library
• properties : print system properties
• agentProperties : print agent properties
• datadump : show heap and thread summary
• threaddump : dump all stack traces (like jstack)
• dumpheap : dump heap (like jmap)
• inspectheap : heap histogram (like jmap -histo)
• setflag : modify manageable VM flag
• printflag : print VM flag
• jcmd : execute jcmd command

$ jattach <pid> load <.so-path> { true | false } [ options ]

Where true means that the path is absolute, false -- the path is relative.

options are passed to the agent.

$ jattach <pid> jcmd "help -all"

On FreeBSD, you can use the following command to install jattach package:

$ pkg install jattach

On Alpine Linux, you can use the following command to install jattach package from the edge/community repository:

$ apk add --no-cache jattach --repository http://dl-cdn.alpinelinux.org/alpine/edge/community/

jattach package can be installed from AUR using one of AUR helpers, e.g., yay:

$ yay -S jattach