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