arm-trusted-firmware/docs
Juan Castillo 40fc6cd141 Add optional platform error handler API
This patch adds an optional API to the platform port:

    void plat_error_handler(int err) __dead2;

The platform error handler is called when there is a specific error
condition after which Trusted Firmware cannot continue. While panic()
simply prints the crash report (if enabled) and spins, the platform
error handler can be used to hand control over to the platform port
so it can perform specific bookeeping or post-error actions (for
example, reset the system). This function must not return.

The parameter indicates the type of error using standard codes from
errno.h. Possible errors reported by the generic code are:

    -EAUTH  : a certificate or image could not be authenticated
              (when Trusted Board Boot is enabled)
    -ENOENT : the requested image or certificate could not be found
              or an IO error was detected
    -ENOMEM : resources exhausted. Trusted Firmware does not use
              dynamic memory, so this error is usually an indication
              of an incorrect array size

A default weak implementation of this function has been provided.
It simply implements an infinite loop.

Change-Id: Iffaf9eee82d037da6caa43b3aed51df555e597a3
2015-10-28 09:13:40 +00:00
..
diagrams PSCI: Add documentation and fix plat_is_my_cpu_primary() 2015-08-13 23:48:07 +01:00
plat docs: fix the command to compile BL31 on Tegra 2015-08-01 11:14:32 +05:30
spd Tegra: retrieve BL32's bootargs from bl32_ep_info 2015-07-31 10:26:22 +05:30
auth-framework.md TBB: add authentication framework documentation 2015-06-25 08:53:27 +01:00
change-log.md Documentation for version 1.1 2015-02-03 11:43:43 +00:00
cpu-specific-build-macros.md cortex_a53: Add A53 errata #826319, #836870 2015-08-05 19:58:39 +08:00
firmware-design.md Re-design bakery lock memory allocation and algorithm 2015-09-11 16:19:21 +01:00
interrupt-framework-design.md Some minor fixes to interrupt-framework-design.md 2015-08-04 12:20:46 +08:00
platform-migration-guide.md docs: Fixes to platform-migration-guide.md 2015-08-18 14:59:25 +01:00
porting-guide.md Add optional platform error handler API 2015-10-28 09:13:40 +00:00
psci-pd-tree.md PSCI: Introduce new platform interface to describe topology 2015-08-13 16:28:26 +01:00
rt-svc-writers-guide.md Documentation for version 1.1 2015-02-03 11:43:43 +00:00
trusted-board-boot.md TBB: add authentication framework documentation 2015-06-25 08:53:27 +01:00
user-guide.md PSCI: Add documentation and fix plat_is_my_cpu_primary() 2015-08-13 23:48:07 +01:00