Bug Report

Edit this article on Github.

Where To File

Please creates a New Issue on GitHub.

Bug Report content

Please be sure to include these in your bug report.

  • The version number, driver will output this on start.

  • The full output, the driver will at least print out some backtrace or error message. Include those.

  • If you can, try to narrow down to a small LPC program that reproduce the problem easily. If you can not, Try using Valgrind method first.

GDB

If you have met an crash, the driver should automatically print out an list of backtrace, but sometime that doesn’t really contain enough information.

If you want to catch the crash, try running driver under GDB directly

gdb --args driver <argumnets>
handle SIGPIPE nostop noprint pass
run

and when you met an crash, do this

bt
info locals

and paste the result to your issue!

Sanitizer

Most of the crashing bug is actually caused by previous silent memory corruption, which it is very hard to detect.

The currently preferred way to detect any sort of memory corruption is to use Sanitizer, that way you catch the problem when it happens, not when it causes other problems. However it mostly only works under Linux.

Here is how you should generate a bug report with Sanitizer.

Build driver in sanitizer enabled mode

$ cmake .. -DENABLE_SANITIZER=ON

Launch driver as usual

$ ./driver <args>

Login to your lib as usual, do something fishy.

(it will be slow, that is okay) You may also have to relax your maximum eval cost setting, if necessary. When Valgrind halts and prints out a backtrace with Invalid read of size 1, or Invalid write of size 1, save the entire stack trace.