source: rtems-docs/rsb/bug-reporting.rst @ 969e60e

5
Last change on this file since 969e60e was 9742e45, checked in by Chris Johns <chrisj@…>, on 11/02/16 at 04:20:35

RSB: Fix the heading level for the PDF.

  • Property mode set to 100644
File size: 2.0 KB
Line 
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
8Bugs, Crashes, and Build Failures
9=================================
10
11The RTEMS Source Builder is a Python program and every care is taken to test
12the code however bugs, crashes, and build failures can and do happen. If you
13find a bug please report it via the :r:url:`devel` or email on the RTEMS Users
14list.
15
16Please include the generated RSB report. If you see the following a report has
17been 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
30The 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
33If 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
43If there is a Python crash please cut and paste the Python backtrace into the
44bug report. If the tools fail to build please locate the first error in the log
45file. This can be difficult to find on hosts with many cores so it sometimes
46pays to re-run the command with the ``--jobs=none`` option to get a log that is
47correctly sequenced. If searching the log file seach for ``error:`` and the
48error should be just above it.
49
50.. _Contributing:
51
52Contributing
53============
54
55We welcome all users adding, fixing, updating and upgrading packages and their
56configurations. The RSB is open source and open to contributions. These can be
57bug fixes, new features or new configurations. Please break patches down into
58changes to the core Python code, configuration changes or new configurations.
59
60Please email patches generated using git so your commit messages and you are
61acknowledged as the contributor.
Note: See TracBrowser for help on using the repository browser.