source: rtems-docs/user/testing/index.rst @ e52906b

5
Last change on this file since e52906b was e52906b, checked in by Sebastian Huber <sebastian.huber@…>, on 01/09/19 at 15:14:06

Simplify SPDX-License-Identifier comment

  • Property mode set to 100644
File size: 2.0 KB
Line 
1.. SPDX-License-Identifier: CC-BY-SA-4.0
2
3.. Copyright (C) 2018 Chris Johns <chrisj@rtems.org>
4
5Testing
6*******
7
8RTEMS developers run test executables when adding new features or testing a bug
9fix. All tests are run to make sure changes do not introduce regressions. Users
10can run the RTEMS tests to be certain the build of the kernel they have is
11functioning.
12
13The section describes using and configuring the RTEMS Tester and RTEMS Run
14tools, the types of laboratory set ups supported and how to add your BSP to the
15framework. The tools command line interfaces are detailed in
16:ref:`rtems-tester-command`.
17
18An RTEMS Test is an RTEMS executable where the application code is a
19test. Tests in RTEMS print banners to the console to indicate the configuration
20of the test and if it has start and finished.
21
22The RTEMS Tools Project provides the RTEMS Tester and RTEMS Run tools. The
23RTEMS Tester command is ``rtems-test`` and the RTEMS Run command is
24``rtems-run``. These commands manage the complexity of running embedded
25executables. The commands provide a consistent command line interface to a
26testing framework that supports the various run time and testing scenarios we
27encounter such as simulators, GDB and executing directly on target hardware.
28
29The RTEMS kernel code contains an extensive set of tests to exercise and test
30the RTEMS kernel. The tests check functionality, provide coverage testing and
31make sure the kernel is operating as intended on your target system. The
32testsuite has support to make creating a test simple and uniform.
33
34The tests are built by adding ``--enable-tests`` to the RTEMS build
35configuration command line. There are over 600 tests and building them does
36extend the RTEMS kernel's build time and use more disk space but it worth
37building and running them. The RTEMS test executables have the ``.exe`` file
38extension.
39
40.. include:: tests.rst
41.. include:: configuration.rst
42.. include:: consoles.rst
43.. include:: simulation.rst
44.. include:: gdb-jtag.rst
45.. include:: tftp.rst
Note: See TracBrowser for help on using the repository browser.