summaryrefslogtreecommitdiffstats
path: root/user/tools
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2017-11-09 10:22:24 +0100
committerSebastian Huber <sebastian.huber@embedded-brains.de>2017-11-09 10:24:09 +0100
commit60a6d6eae95ad49b9ddf53c6767f22aa4b3897a2 (patch)
treed583eef52c8eede702361fd09cb82cab1ad778a8 /user/tools
parent120c8a09e6f8f857b6933c7119c18903f2f869d5 (diff)
downloadrtems-docs-60a6d6eae95ad49b9ddf53c6767f22aa4b3897a2.tar.bz2
Change RTEMS version to 5
Update #3220.
Diffstat (limited to 'user/tools')
-rw-r--r--user/tools/bsp-builder.rst26
-rw-r--r--user/tools/exeinfo.rst166
-rw-r--r--user/tools/symbols.rst18
-rw-r--r--user/tools/tester.rst22
4 files changed, 118 insertions, 114 deletions
diff --git a/user/tools/bsp-builder.rst b/user/tools/bsp-builder.rst
index 8ed1240..605fc9d 100644
--- a/user/tools/bsp-builder.rst
+++ b/user/tools/bsp-builder.rst
@@ -347,12 +347,12 @@ need to be regression tested:
.. code-block:: shell
- $ /opt/rtems/4.12/bin/rtems-bsp-builder --build-path=/build/rtems \
- --rtems-tools=/opt/work/rtems/4.12 \
- --rtems=/opt/work/chris/rtems/kernel/rtems.git \
- --profiles=tier-1 \
+ $ /opt/rtems/5/bin/rtems-bsp-builder --build-path=/build/rtems \
+ --rtems-tools=/opt/work/rtems/5 \
+ --rtems=/opt/work/chris/rtems/kernel/rtems.git \
+ --profiles=tier-1 \
--jobs=5/10
- RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (61ddcfc8f057)
+ RTEMS Tools Project - RTEMS Kernel BSP Builder, 5.not_released
Profile(s): tier-1
Cleaning: bsp-builds
[ 1/655] arm/altcycv_devkit (debug) Start
@@ -396,14 +396,14 @@ To build a couple of BSPs you are interested in with tests:
.. code-block:: shell
- $ /opt/rtems/4.12/bin/rtems-bsp-builder --build-path=/build/rtems \
- --rtems-tools=/opt/work/rtems/4.12 \
- --rtems=/opt/work/chris/rtems/kernel/rtems.git \
- ----log=lpc-log \
+ $ /opt/rtems/5/bin/rtems-bsp-builder --build-path=/build/rtems \
+ --rtems-tools=/opt/work/rtems/5 \
+ --rtems=/opt/work/chris/rtems/kernel/rtems.git \
+ ----log=lpc-log \
--bsp=arm/lpc2362,arm/lpc23xx_tli800 \
--build=tests \
--jobs=5/12
- RTEMS Tools Project - RTEMS Kernel BSP Builder, 4.12 (61ddcfc8f057 modified)
+ RTEMS Tools Project - RTEMS Kernel BSP Builder, 5.not_released
BSPS(s): arm/lpc2362, arm/lpc23xx_tli800
Cleaning: bsp-builds
[1/2] arm/lpc2362 (tests) Start
@@ -428,15 +428,15 @@ To build a couple of BSPs you are interested in with tests:
Failures:
1 tests arm/lpc2362 build:
configure: /opt/work/chris/rtems/kernel/rtems.git/configure --target\
- =arm-rtems4.12 --enable-rtemsbsp=lpc2362 --prefix=/opt/rtems/4.12\
+ =arm-rtems5 --enable-rtemsbsp=lpc2362 --prefix=/opt/rtems/5\
--enable-tests
error: ld/collect2:0 error: math.exe section '.rodata' will not fit
in region 'ROM_INT'; region 'ROM_INT' overflowed by 7284 bytes
2 tests arm/lpc23xx_tli800 build:
configure: /opt/work/chris/rtems/kernel/rtems.git/configure --target\
- =arm-rtems4.12 --enable-rtemsbsp=lpc23xx_tli800\
- --prefix=/opt/rtems/4.12 --enable-tests
+ =arm-rtems5 --enable-rtemsbsp=lpc23xx_tli800\
+ --prefix=/opt/rtems/5 --enable-tests
error: ld/collect2:0 error: math.exe section '.text' will not fit in
region 'ROM_INT'; region 'ROM_INT' overflowed by 13972 bytes
diff --git a/user/tools/exeinfo.rst b/user/tools/exeinfo.rst
index 522c6e5..f226b7d 100644
--- a/user/tools/exeinfo.rst
+++ b/user/tools/exeinfo.rst
@@ -95,60 +95,66 @@ Prints all reports for the ``hello.exe`` for the ``i386/pc686`` BSP:
.. code-block:: shell
- $ rtems-exeinfo -a i386-rtems4.12/c/pc686/testsuites/samples/hello/hello.exe
- RTEMS Executable Info 4.12.a72a462adc18
- rtems-exeinfo -a i386-rtems4.12/c/pc686/testsuites/samples/hello/hello.exe
- exe: i386-rtems4.12/c/pc686/testsuites/samples/hello/hello.exe
- Sections: 23
- -------------- address: 0x00000000 0x00000000 size: 0 align: 0 relocs: 0
- .bss WA------------ address: 0x0013f340 0x00144d9c size: 23132 align: 32 relocs: 0
- .comment ---MS--------- address: 0x00000000 0x0000008f size: 143 align: 1 relocs: 0
- .ctors WA------------ address: 0x0013cc9c 0x0013cca4 size: 8 align: 4 relocs: 0
- .data WA------------ address: 0x0013ccc0 0x0013f32c size: 9836 align: 32 relocs: 0
- .debug_abbrev -------------- address: 0x00000000 0x0003ef4c size: 257868 align: 1 relocs: 0
- .debug_aranges -------------- address: 0x00000000 0x00003da8 size: 15784 align: 8 relocs: 0
- .debug_info -------------- address: 0x00000000 0x0036dd9e size: 3595678 align: 1 relocs: 0
- .debug_line -------------- address: 0x00000000 0x00072dca size: 470474 align: 1 relocs: 0
- .debug_loc -------------- address: 0x00000000 0x0003fd2c size: 261420 align: 1 relocs: 0
- .debug_ranges -------------- address: 0x00000000 0x00009738 size: 38712 align: 1 relocs: 0
- .debug_str ---MS--------- address: 0x00000000 0x0001bf78 size: 114552 align: 1 relocs: 0
- .dtors WA------------ address: 0x0013cca4 0x0013ccac size: 8 align: 4 relocs: 0
- .eh_frame -A------------ address: 0x00134340 0x0013bc9c size: 31068 align: 4 relocs: 0
- .fini -AE----------- address: 0x0012d8a9 0x0012d8b1 size: 8 align: 1 relocs: 0
- .init -AE----------- address: 0x0012d89c 0x0012d8a9 size: 13 align: 1 relocs: 0
- .jcr WA------------ address: 0x0013ccac 0x0013ccb0 size: 4 align: 4 relocs: 0
- .rodata -A------------ address: 0x0012d8c0 0x0013433d size: 27261 align: 32 relocs: 0
- .rtemsroset WA------------ address: 0x0012d860 0x0012d89c size: 60 align: 4 relocs: 0
- .shstrtab -------------- address: 0x00000000 0x000000cb size: 203 align: 1 relocs: 0
- .strtab -------------- address: 0x00000000 0x0000772a size: 30506 align: 1 relocs: 0
- .symtab -------------- address: 0x00000000 0x00007120 size: 28960 align: 4 relocs: 0
- .text WAE----------- address: 0x00100000 0x0012d860 size: 186464 align: 16 relocs: 0
-
- Init sections: 2
+ $ rtems-exeinfo -a i386-rtems5/c/pc686/testsuites/samples/hello/hello.exe
+ RTEMS Executable Info 5.6f5cfada964c
+ rtems-exeinfo -a i386-rtems5/c/pc686/testsuites/samples/hello/hello.exe
+ exe: i386-rtems5/c/pc686/testsuites/samples/hello/hello.exe
+ Sections: 22
+ -------------- addr: 0x00000000 0x00000000 size: 0 align: 0 relocs: 0
+ .bss WA------------ addr: 0x00135760 0x0013b300 size: 23456 align: 32 relocs: 0
+ .comment ---MS--------- addr: 0x00000000 0x00000083 size: 131 align: 1 relocs: 0
+ .ctors WA------------ addr: 0x0013322c 0x00133234 size: 8 align: 4 relocs: 0
+ .data WA------------ addr: 0x00133240 0x0013574c size: 9484 align: 32 relocs: 0
+ .debug_abbrev -------------- addr: 0x00000000 0x0003c5ce size: 247246 align: 1 relocs: 0
+ .debug_aranges -------------- addr: 0x00000000 0x00003a18 size: 14872 align: 8 relocs: 0
+ .debug_info -------------- addr: 0x00000000 0x0032496d size: 3295597 align: 1 relocs: 0
+ .debug_line -------------- addr: 0x00000000 0x0006606b size: 417899 align: 1 relocs: 0
+ .debug_loc -------------- addr: 0x00000000 0x0003b704 size: 243460 align: 1 relocs: 0
+ .debug_ranges -------------- addr: 0x00000000 0x00008128 size: 33064 align: 1 relocs: 0
+ .debug_str ---MS--------- addr: 0x00000000 0x0001a9d7 size: 109015 align: 1 relocs: 0
+ .dtors WA------------ addr: 0x00133234 0x0013323c size: 8 align: 4 relocs: 0
+ .eh_frame -A------------ addr: 0x0012b884 0x0013222c size: 27048 align: 4 relocs: 0
+ .fini -AE----------- addr: 0x00127fdd 0x00127fe5 size: 8 align: 1 relocs: 0
+ .init -AE----------- addr: 0x00127fd0 0x00127fdd size: 13 align: 1 relocs: 0
+ .rodata -A------------ addr: 0x00128000 0x0012b884 size: 14468 align: 32 relocs: 0
+ .rtemsroset WA------------ addr: 0x00127f94 0x00127fd0 size: 60 align: 4 relocs: 0
+ .shstrtab -------------- addr: 0x00000000 0x000000c6 size: 198 align: 1 relocs: 0
+ .strtab -------------- addr: 0x00000000 0x000068ca size: 26826 align: 1 relocs: 0
+ .symtab -------------- addr: 0x00000000 0x00006290 size: 25232 align: 4 relocs: 0
+ .text WAE----------- addr: 0x00100000 0x00127f91 size: 163729 align: 16 relocs: 0
+
+ Init sections: 3
.ctors
0xffffffff RamSize
- 0x00000000 _TLS_Data_size
+ 0x00000000 REG_EFLAGS
+ .init
+ 0xfd81ebe8 no symbol
+ 0xff86e8ff no symbol
+ 0x00c2ffff no symbol
.rtemsroset
- 0x00100280 bsp_work_area_initialize
- 0x001003b0 bsp_start_default
- 0x0011ace0 _User_extensions_Handler_initialization
- 0x00113040 rtems_initialize_data_structures
- 0x00112ec0 _RTEMS_tasks_Manager_initialization
- 0x0011df30 _Message_queue_Manager_initialization
- 0x0011cfa0 _Semaphore_Manager_initialization
- 0x0011ce70 _POSIX_Keys_Manager_initialization
- 0x00117360 _Thread_Create_idle
- 0x0010c8d0 rtems_libio_init
- 0x0010c7c0 rtems_filesystem_initialize
- 0x00100390 bsp_predriver_hook
- 0x001130f0 _IO_Initialize_all_drivers
- 0x00112d90 _RTEMS_tasks_Initialize_user_tasks_body
- 0x0010d520 rtems_libio_post_driver
-
- Fini sections: 1
+ 0x00100310 bsp_work_area_initialize
+ 0x00100440 bsp_start_default
+ 0x001160e0 _User_extensions_Handler_initialization
+ 0x0010fe60 rtems_initialize_data_structures
+ 0x0010fcf0 _RTEMS_tasks_Manager_initialization
+ 0x0010f310 _Semaphore_Manager_initialization
+ 0x0010ed90 _POSIX_Keys_Manager_initialization
+ 0x00113af0 _Thread_Create_idle
+ 0x0010c100 rtems_libio_init
+ 0x0010bec0 rtems_filesystem_initialize
+ 0x00100420 bsp_predriver_hook
+ 0x0010bfb0 _Console_simple_Initialize
+ 0x0010ff30 _IO_Initialize_all_drivers
+ 0x0010fc10 _RTEMS_tasks_Initialize_user_tasks_body
+ 0x0010ccb0 rtems_libio_post_driver
+
+ Fini sections: 2
.dtors
0xffffffff RamSize
- 0x00000000 _TLS_Data_size
+ 0x00000000 REG_EFLAGS
+ .fini
+ 0xfd815ee8 no symbol
+ 0x0000c2ff no symbol
The Init section ``.rtemsroset`` shows the initialisation call order for the
``hello.exe`` sample application. The order is initialise the BSP work area,
@@ -163,41 +169,39 @@ Print the ``Init`` section data for the ``cdtest.exe`` for the ``i386/pc686`` BS
.. code-block:: shell
- $ rtems-exeinfo -I i386-rtems4.12/c/pc686/testsuites/samples/cdtest/cdtest.exe
- RTEMS Executable Info 4.12.a72a462adc18
- rtems-exeinfo -I i386-rtems4.12/c/pc686/testsuites/samples/cdtest/cdtest.exe
- exe: i386-rtems4.12/c/pc686/testsuites/samples/cdtest/cdtest.exe
- Init sections: 2
+ $ rtems-exeinfo -I i386-rtems5/c/pc686/testsuites/samples/cdtest/cdtest.exe
+ RTEMS Executable Info 5.6f5cfada964c
+ rtems-exeinfo -I i386-rtems5/c/pc686/testsuites/samples/cdtest/cdtest.exe
+ exe: i386-rtems5/c/pc686/testsuites/samples/cdtest/cdtest.exe
+ Init sections: 3
.ctors
0xffffffff RamSize
- 0x00100e90 rtems_test_name
- 0x001014b0 __gnu_cxx::__freeres()
- 0x001017c0 __cxa_get_globals_fast
- 0x001024e0 __cxxabiv1::__terminate(void (*)())
- 0x001030a0 std::_V2::error_category::~error_category()
- 0x0010cfa0 std::ctype_byname<char>::ctype_byname(std::string const&, unsigned long)
- 0x0010d070 std::ctype_byname<wchar_t>::ctype_byname(std::string const&, unsigned long)
- 0x0010d210 std::nothrow
- 0x0010d230 std::ctype_byname<char>::ctype_byname(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, unsigned long)
- 0x0010d2c0 std::ctype_byname<wchar_t>::ctype_byname(std::__cxx11::basic_string<char, std::char_traits<char>, std::allocator<char> > const&, unsigned long)
- 0x00000000 _TLS_Data_size
+ 0x00100ea0 _GLOBAL__sub_I_rtems_test_name
+ 0x001015d0 __gnu_cxx::__freeres()
+ 0x00101df0 __cxxabiv1::__terminate(void (*)())
+ 0x00102ac0 _GLOBAL__sub_I___cxa_get_globals_fast
+ 0x00103260 std::nothrow
+ 0x00000000 REG_EFLAGS
+ .init
+ 0xfcb3dbe8 no symbol
+ 0xff86e8ff no symbol
+ 0x00c2ffff no symbol
.rtemsroset
- 0x00111210 bsp_work_area_initialize
- 0x00111340 bsp_start_default
- 0x0012c560 _User_extensions_Handler_initialization
- 0x001244d0 rtems_initialize_data_structures
- 0x00124350 _RTEMS_tasks_Manager_initialization
- 0x0012f790 _Message_queue_Manager_initialization
- 0x0012e7c0 _Semaphore_Manager_initialization
- 0x0013ccc0 _POSIX_signals_Manager_Initialization
- 0x0012e650 _POSIX_Keys_Manager_initialization
- 0x00128be0 _Thread_Create_idle
- 0x0011d9d0 rtems_libio_init
- 0x0011d8c0 rtems_filesystem_initialize
- 0x00111320 bsp_predriver_hook
- 0x00124580 _IO_Initialize_all_drivers
- 0x00124220 _RTEMS_tasks_Initialize_user_tasks_body
- 0x0011e620 rtems_libio_post_driver
+ 0x001112c0 bsp_work_area_initialize
+ 0x001113f0 bsp_start_default
+ 0x001276c0 _User_extensions_Handler_initialization
+ 0x00121260 rtems_initialize_data_structures
+ 0x001210f0 _RTEMS_tasks_Manager_initialization
+ 0x00120710 _Semaphore_Manager_initialization
+ 0x0011ff70 _POSIX_Keys_Manager_initialization
+ 0x001250d0 _Thread_Create_idle
+ 0x0011d220 rtems_libio_init
+ 0x0011cfe0 rtems_filesystem_initialize
+ 0x001113d0 bsp_predriver_hook
+ 0x0011d0d0 _Console_simple_Initialize
+ 0x00121310 _IO_Initialize_all_drivers
+ 0x00121010 _RTEMS_tasks_Initialize_user_tasks_body
+ 0x0011ddd0 rtems_libio_post_driver
The C++ constructor section ``.ctors`` shows you the C++ static objects the
RTEMS kernel will construct before calling ``main``.
diff --git a/user/tools/symbols.rst b/user/tools/symbols.rst
index 91ba077..e3894e6 100644
--- a/user/tools/symbols.rst
+++ b/user/tools/symbols.rst
@@ -115,8 +115,8 @@ Command
.. option:: -E, --exec-prefix
- Specify the RTEMS tool prefix. For example for RTEMS 4.12 and the SPARC
- architecture the prefix is ``sparc-rtems4.12``.
+ Specify the RTEMS tool prefix. For example for RTEMS 5 and the SPARC
+ architecture the prefix is ``sparc-rtems5``.
.. option:: -c, --cflags
@@ -136,7 +136,7 @@ program for the ``i386/pc686`` BSP:
.. code-block:: shell
- $ rtems-syms -o ms.o i386-rtems4.12/c/pc686/testsuites/samples/minimum/minimum.exe
+ $ rtems-syms -o ms.o i386-rtems5/c/pc686/testsuites/samples/minimum/minimum.exe
$ file ms.o
ms.o: ELF 32-bit LSB relocatable, Intel 80386, version 1 (SYSV), not stripped
@@ -144,10 +144,10 @@ Run the same command, this time create a map file:
.. code-block:: shell
- $ rtems-syms -o ms.o -m ms.map i386-rtems4.12/c/pc686/testsuites/samples/minimum/minimum.exe
+ $ rtems-syms -o ms.o -m ms.map i386-rtems5/c/pc686/testsuites/samples/minimum/minimum.exe
$ head -10 ms.map
RTEMS Kernel Symbols Map
- kernel: i386-rtems4.12/c/pc686/testsuites/samples/minimum/minimum.exe
+ kernel: i386-rtems5/c/pc686/testsuites/samples/minimum/minimum.exe
Globals:
No. Index Scope Type SHNDX Address Size Name
@@ -162,12 +162,12 @@ command performs:
.. code-block:: shell
- $ rtems-syms -vvv -o ms.o i386-rtems4.12/c/pc686/testsuites/samples/minimum/minimum.exe
- RTEMS Kernel Symbols 4.12.a72a462adc18
- kernel: i386-rtems4.12/c/pc686/testsuites/samples/minimum/minimum.exe
+ $ rtems-syms -vvv -o ms.o i386-rtems5/c/pc686/testsuites/samples/minimum/minimum.exe
+ RTEMS Kernel Symbols 5.a72a462adc18
+ kernel: i386-rtems5/c/pc686/testsuites/samples/minimum/minimum.exe
cache:load-sym: object files: 1
cache:load-sym: symbols: 1043
symbol C file: /tmp/rld--X7paaa.c
symbol O file: ms.o
- execute: i386-rtems4.12-gcc -O2 -c -o ms.o /tmp/rld--X7paaa.c
+ execute: i386-rtems5-gcc -O2 -c -o ms.o /tmp/rld--X7paaa.c
execute: status: 0
diff --git a/user/tools/tester.rst b/user/tools/tester.rst
index 950e364..6e79799 100644
--- a/user/tools/tester.rst
+++ b/user/tools/tester.rst
@@ -76,7 +76,7 @@ configure after running ``bootstrap``.
.. code-block:: shell
- $ ../../rtems.git/configure --target=sparc-rtems4.12 \
+ $ ../../rtems.git/configure --target=sparc-rtems5 \
--enable-tests --enable-rtemsbsp=erc32
$ make
@@ -92,7 +92,7 @@ run command:
.. code-block:: shell
- $ sparc-rtems4.12-run sparc-rtems4.12/c/erc32/testsuites/samples/hello/hello.exe
+ $ sparc-rtems5-run sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
*** BEGIN OF TEST HELLO WORLD ***
Hello World
@@ -104,14 +104,14 @@ Running the example using GDB:
.. code-block:: shell
- $ sparc-rtems4.12-gdb sparc-rtems4.12/c/erc32/testsuites/samples/hello/hello.exe
+ $ sparc-rtems5-gdb sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
GNU gdb (GDB) 7.12
Copyright (C) 2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law. Type "show copying"
and "show warranty" for details.
- This GDB was configured as "--host=x86_64-linux-gnu --target=sparc-rtems4.12".
+ This GDB was configured as "--host=x86_64-linux-gnu --target=sparc-rtems5".
Type "show configuration" for configuration details.
For bug reporting instructions, please see:
<http://www.gnu.org/software/gdb/bugs/>.
@@ -120,12 +120,12 @@ Running the example using GDB:
For help, type "help".
Type "apropos word" to search for commands related to "word"...
Reading symbols from
- sparc-rtems4.12/c/erc32/testsuites/samples/hello/hello.exe...done.
+ sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe...done.
(gdb) target sim
Connected to the simulator.
(gdb) load
(gdb) r
- Starting program: sparc-rtems4.12/c/erc32/testsuites/samples/hello/hello.exe
+ Starting program: sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
*** BEGIN OF TEST HELLO WORLD ***
@@ -158,9 +158,9 @@ BSP build tree:
$ ~/development/rtems/test/rtems-tools.git/tester/rtems-test \
--log=log_erc32_run \
--rtems-bsp=erc32-run \
- --rtems-tools=$HOME/development/rtems/4.12 \
- sparc-rtems4.12/c/erc32/testsuites/samples
- RTEMS Testing - Tester, 4.12.not_released
+ --rtems-tools=$HOME/development/rtems/5 \
+ sparc-rtems5/c/erc32/testsuites/samples
+ RTEMS Testing - Tester, 5.not_released
[ 1/13] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 | sparc/erc32: base_sp.exe
[ 2/13] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 | sparc/erc32: capture.exe
[ 3/13] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0 | sparc/erc32: cdtest.exe
@@ -206,8 +206,8 @@ BSP build tree:
* The output shows the average time per test and the total time taken to run
all the tests.
* If the path to the testsuites was put to
- ``sparc-rtems4.12/c/erc32/testsuites`` instead of
- ``sparc-rtems4.12/c/erc32/testsuites/samples`` then all the executables
+ ``sparc-rtems5/c/erc32/testsuites`` instead of
+ ``sparc-rtems5/c/erc32/testsuites/samples`` then all the executables
would have been tested and not just those in samples.
This BSP requires the ``--rtems-tools`` option because the SPARC GDB is the