source: rtems-docs/user/rsb/bug-reporting.rst @ 2e6f49f

5
Last change on this file since 2e6f49f was 60ed99d, checked in by Sebastian Huber <sebastian.huber@…>, on 01/11/19 at 09:20:08

user: Add RSB content as a chapter

Remove the separate RSB manual.

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