This directory contains python script to help debugging HPX applications with gdb. In order to use it, please add the following lines to your ~/.gdbinit:

source $HPX_SRC_DIR/tools/gdb/hpx.py

define hook-continue
hpx thread restore
end

For a list of commands see help hpx inside of gdb.

Notes:

• The scripts currently only work when HPX is compiled against Boost 1.56
• The scripts currently only work with the local priority scheduler
• The scripts currently only work on 64 bit executables
• The scripts currently only work with the x86_linux_context context implementation (which is the default on Linux X86_64)
• The hook-continue is needed because we currently just overwrite the current frame with the selected HPX user level context.

By not doing a hpx thread restore before gdb continues execution, your program will abort.