Hiawatha
A secure and advanced webserver

HOWTO: Handling a crash

If you experience a Hiawatha crash or a memory leak, please follow these instructions to help me find the bug:

  • Make sure you have the latest version of Hiawatha.
  • Install valgrind.
  • Recompile Hiawatha without stripping the binary. Its size should be around 750kB instead of the usual 160kB.
  • Run Hiawatha via valgrind:
    bash
    sudo valgrind --tool=memcheck --leak-check=full ./hiawatha -d 2> valgrind.txt
    
  • In case of a crash, reproduce it. In case of a memory leak, run Hiawatha for a while until the leak shows up. Tip: use the tool 'screen' for that.
  • Send the valgrind.txt file to hugo at hiawatha dash webserver dot org.

Thanks in advance!