How do I use stackshot to debug my application?

Question

I've recently been told about a useful debugging tool on Mac OS X called stackshot, however I don't know how to invoke it. My understanding from the documentation is that it runs as a daemon, but the man page also reads as if it can be invoked from the command line. How would I go about leveraging stackshot for my currently-running application?

Answer 1

sudo /usr/libexec/stackshot -i

Stackshot is intended for debugging system-wide issues (deadlocks etc), not single applications; as such it creates a stack dump of the entire system, not a single application.

With the default configuration, this will create a stack shot in /Library/Logs/stackshot.log