How to report an issue

How to start

One of the ways to contribute to Soletta is reporting issues.

This process is really straight-forward, but providing the right information from the beginning is important to avoid many rounds of interaction between the reporter and the assignee. So before opening the issue, take a quick list about what can you provide to get us to a faster solution.

To open an issue:

New ticket

Also it's nice to see if there isn't a ticket reporting it already. If it's the case, you may just add information to it.

Issues list can be found at:

List of issues

Information needed for any kind of issue

Please inform if you are using one of our images, or if you built Soletta yourself.

We need to know what is the platform, OS, architecture of both host (machine you used to build Soletta) and target.

Version of Soletta used is also required. Inform the top commit hash.

Information needed for cases of build issues or modules not found

If Soletta is:

• failing to build
• or if it's failing to find one of its modules or node types - messages like:
  • WRN:sol-flow ./src/lib/flow/sol-flow-resolver-conffile.c:213 _resolver_conffile_get_module() Type='oic/server-light' not found.

You should share:

• make verbose log:
  • $ make V=1
• .config (it's created by kbuild and should be on root of build directory)
• .config.log
• strace log

Information of issues on runtime

• Build Soletta for debug:

  • $ make menuconfig
  • Select "Basic" option on Menu
  • Select compiler options
  • Select "debug" mode

• Share a Soletta log. You can generate it set log levels to the max:

  • $ export SOL_LOG_LEVEL=5

Information needed for cases of segmentation fault

In these cases, please share (if possible in your target):

• valgrind log:
  • $ valgrind sol-fbp-runner test.fbp