This is a simple library (and a convenient executable) to profile Lua functions.

Usage

Install

Compile and install it by running

make
sudo make install

You can also append PREFIX=xxx when running these commands to install to a different location.

Running

usage: luaprofile -l LUA_LIBRARY [-o LOGFILE] [-L PRELOAD_LIB] COMMAND ...

      -l, --lualib              The Lua library
      -o, --logfile             The log file, if not stderr
      -L, --preloadlib          The 'luaprofile.so' library, if not at default location

environment variables 'LUAP_LIBRARY', 'LUAP_LOGFILE' also work.

Signals

• Sending a SIGPROF signal will make it print stats on next Lua function call.
• Sending a SIGPWR signal will make it print stats on next Lua function call, free the memory it used and remove the debug hook.

Note

• Lua must be loaded as a dynamic library, not statically linked into the binary you will run.
• Works on Linux. Might also work on Mac OS X / FreeBSD.
• May not work if running as root.