.. comment SPDX-License-Identifier: CC-BY-SA-4.0 .. comment COPYRIGHT (c) 2012 - 2016. .. comment Chris Johns .. _Bugs, Crashes, and Build Failures: Bugs, Crashes, and Build Failures ================================= The RTEMS Source Builder is a Python program and every care is taken to test the code however bugs, crashes, and build failures can and do happen. If you find a bug please report it via the :r:url:`devel` or email on the RTEMS Users list. Please include the generated RSB report. If you see the following a report has been generated:: ... ... Build FAILED <1> See error report: rsb-report-4.11-rtems-lm32.txt <2> .. topic:: Items: 1. The build has failed. 2. The report's file name. The generated report contains the command line, version of the RSB, your host's ``uname`` details, the version of Python and the last 200 lines of the log. If for some reason there is no report please send please report the following: - Command line, - The git hash, - Host details with the output of the ``uname -a`` command, - If you have made any modifications. If there is a Python crash please cut and paste the Python backtrace into the bug report. If the tools fail to build please locate the first error in the log file. This can be difficult to find on hosts with many cores so it sometimes pays to re-run the command with the ``--jobs=none`` option to get a log that is correctly sequenced. If searching the log file seach for ``error:`` and the error should be just above it. .. _Contributing: Contributing ============ We welcome all users adding, fixing, updating and upgrading packages and their configurations. The RSB is open source and open to contributions. These can be bug fixes, new features or new configurations. Please break patches down into changes to the core Python code, configuration changes or new configurations. Please email patches generated using git so your commit messages and you are acknowledged as the contributor.