Notice: We have migrated to GitLab launching 2024-05-01 see here:

Changes between Version 4 and Version 5 of Developer/Tracing/Trace_Linker

03/16/15 00:20:31 (9 years ago)
Chris Johns



  • Developer/Tracing/Trace_Linker

    v4 v5  
    4343The trace linker uses the INI file format for configuration files. Users provide a top level configuration that defines the trace executable created.  The trace linker comes with a number of standard configurations that provide a range of functionality. A user can use those configurations or they can define a completely new set and produce a localised specific form or trace executable.
     45=== INI Files ===
     47[ INI files format] consist of sections with a section name that groups keys A key has a name and value used as `name=value`. An example format is:
     52name2 = value2
     55The use of keys depends on the user of the INI file and in our case this is the trace linker. The trace linker can include other INI files using the `include` key name and a comma separated list of files to include:
     58include = rtems.ini, rtld-base.ini
     61The trace linker also uses values in key to specify other sections. In this example the `functions` name lists `test-trace-funcs` and that section a `headers` key that references a further section `test-headers`:
     64functions = test-trace-funcs, rtems-api
     67; Parsed via the 'function-set', not parse as a 'trace'.
     68headers = test-headers
     71header = '#include "test-trace-1.h"'
     74The ability to include INI files and have key lists reference sections lets the trace linker provide base functionality a user can specialise.
     76=== Tracer Section ===
     78The top level section is `[tracer]`. The tracer section can contain the following keys:
     80 name:: A user defined name for the trace.
     81 bsp:: The BSP as an RTEMS standard `arch/bsp` pair. Currently not used.
     82 options:: Various trace linker defined options. Currently not used.
     83 traces:: List of trace sections. A trace section defines how functions are to be instrumented.
     84 functions:: List function sections. Function sections list the functions to be instrumented.
     86=== Trace Section ===
     88A trace section defines how trace wrapper functions are built.
    4590== Wrapping ==