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. |
---|