[8b64335] | 1 | .. comment SPDX-License-Identifier: CC-BY-SA-4.0 |
---|
| 2 | |
---|
| 3 | .. comment COPYRIGHT (c) 2012 - 2016. |
---|
| 4 | .. comment Chris Johns <chrisj@rtems.org> |
---|
| 5 | |
---|
| 6 | .. _Bugs, Crashes, and Build Failures: |
---|
| 7 | |
---|
| 8 | Bugs, Crashes, and Build Failures |
---|
| 9 | ################################# |
---|
| 10 | |
---|
| 11 | The RTEMS Source Builder is a Python program and every care is taken to test |
---|
| 12 | the code however bugs, crashes, and build failures can and do happen. If you |
---|
| 13 | find a bug please report it via the :r:url:`devel` or email on the RTEMS Users |
---|
| 14 | list. |
---|
| 15 | |
---|
| 16 | Please include the generated RSB report. If you see the following a report has |
---|
| 17 | been generated:: |
---|
| 18 | |
---|
| 19 | ... |
---|
| 20 | ... |
---|
| 21 | Build FAILED <1> |
---|
| 22 | See error report: rsb-report-4.11-rtems-lm32.txt <2> |
---|
| 23 | |
---|
| 24 | .. topic:: Items: |
---|
| 25 | |
---|
| 26 | 1. The build has failed. |
---|
| 27 | |
---|
| 28 | 2. The report's file name. |
---|
| 29 | |
---|
| 30 | The generated report contains the command line, version of the RSB, your host's |
---|
| 31 | ``uname`` details, the version of Python and the last 200 lines of the log. |
---|
| 32 | |
---|
| 33 | If for some reason there is no report please send please report the following: |
---|
| 34 | |
---|
| 35 | - Command line, |
---|
| 36 | |
---|
| 37 | - The git hash, |
---|
| 38 | |
---|
| 39 | - Host details with the output of the ``uname -a`` command, |
---|
| 40 | |
---|
| 41 | - If you have made any modifications. |
---|
| 42 | |
---|
| 43 | If there is a Python crash please cut and paste the Python backtrace into the |
---|
| 44 | bug report. If the tools fail to build please locate the first error in the log |
---|
| 45 | file. This can be difficult to find on hosts with many cores so it sometimes |
---|
| 46 | pays to re-run the command with the ``--jobs=none`` option to get a log that is |
---|
| 47 | correctly sequenced. If searching the log file seach for ``error:`` and the |
---|
| 48 | error should be just above it. |
---|
| 49 | |
---|
| 50 | .. _Contributing: |
---|
| 51 | |
---|
| 52 | Contributing |
---|
| 53 | ############ |
---|
| 54 | |
---|
| 55 | We welcome all users adding, fixing, updating and upgrading packages and their |
---|
| 56 | configurations. The RSB is open source and open to contributions. These can be |
---|
| 57 | bug fixes, new features or new configurations. Please break patches down into |
---|
| 58 | changes to the core Python code, configuration changes or new configurations. |
---|
| 59 | |
---|
| 60 | Please email patches generated using git so your commit messages and you are |
---|
| 61 | acknowledged as the contributor. |
---|