arm-trusted-firmware/docs
Douglas Raillard 0c62883f7e backtrace: Introduce backtrace function
This function diplays the backtrace, the current EL and security state
to allow a post-processing tool to choose the right binary to interpret
the dump.

The output can be fed to GNU addr2line to resolve function names given
an ELF binary compiled with debug information. The "-i" flag is
recommended to improve display in case of inlined functions. The *.dump
files generated during the build process can also be used.

The function works in AArch64 and AArch32. In AArch32 it only works in
A32 mode (without T32 interworking), which is enforced in the Makefile.

Sample output of a backtrace at EL3:

    BACKTRACE: START: function_name
    0: EL3: 0x798
    1: EL3: 0x538
    2: EL3: 0x550
    3: EL3: 0x55c
    4: EL3: 0x568
    5: EL3: 0x5a8
    6: EL3: 0xf4
    BACKTRACE: END: function_name

In order to enable it the new option ENABLE_BACKTRACE must be set to 1.
This option is set to 1 by default only in AArch64 debug builds. As
usual, it can be overridden by the platform makefile and in the build
command line.

Change-Id: Icaff39b0e5188329728be2f3c72b868b2368e794
Co-authored-by: Antonio Nino Diaz <antonio.ninodiaz@arm.com>
Signed-off-by: Antonio Nino Diaz <antonio.ninodiaz@arm.com>
Signed-off-by: Douglas Raillard <douglas.raillard@arm.com>
2018-08-30 09:21:53 +01:00
..
diagrams Add Secure Partition Manager (SPM) design document 2017-12-15 11:47:22 +00:00
marvell docs: Add Marvell build and porting documents 2018-07-18 18:48:30 +03:00
plantuml SDEI: Make dispatches synchronous 2018-06-21 16:15:23 +01:00
plat stm32mp1: Add platform documentation 2018-07-24 17:18:45 +02:00
spd Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
arm-sip-service.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
auth-framework.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
change-log.rst Update change-log.rst for v1.5 2018-03-15 17:00:34 +00:00
cpu-specific-build-macros.rst DSU erratum 936184 workaround 2018-08-17 10:34:43 +01:00
firmware-design.rst ARM platforms: Initialize cntfrq for BL1 Firmware update 2018-06-26 15:55:46 +01:00
firmware-update.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
interrupt-framework-design.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
platform-interrupt-controller-API.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
platform-migration-guide.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
porting-guide.rst libc: Introduce files from SCC 2018-08-22 10:26:05 +01:00
psci-lib-integration-guide.rst libc: Move tf_printf and tf_snprintf to libc 2018-08-22 10:26:05 +01:00
psci-pd-tree.rst Fix typo in documentation page title 2018-08-15 14:54:40 +01:00
reset-design.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
rt-svc-writers-guide.rst Rename 'smcc' to 'smccc' 2018-03-21 10:49:27 +00:00
sdei.rst SDEI: Make dispatches synchronous 2018-06-21 16:15:23 +01:00
secure-partition-manager-design.rst plat/arm: SPM: Force BL31 to DRAM when SPM is used 2018-05-24 09:15:03 +01:00
trusted-board-boot.rst Update Arm TF references to TF-A 2018-03-15 17:00:34 +00:00
user-guide.rst backtrace: Introduce backtrace function 2018-08-30 09:21:53 +01:00
xlat-tables-lib-v2-design.rst xlat v2: Update documentation 2018-07-03 14:56:31 +01:00