aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorDimitris Papastamos <dimitris.papastamos@arm.com>2019-03-21 12:40:35 +0000
committerGitHub <noreply@github.com>2019-03-21 12:40:35 +0000
commit46d58f80afc994f522db4340270f1bcbb0c56fb1 (patch)
tree0d3e50265b2c2475716550b34c91892709c27a77 /docs
parentcc0dcf428f047454d96461aa06327cfb528e7270 (diff)
parentae2e01b8760618c374a605dbe4898945595cb136 (diff)
downloadplatform_external_arm-trusted-firmware-46d58f80afc994f522db4340270f1bcbb0c56fb1.tar.gz
platform_external_arm-trusted-firmware-46d58f80afc994f522db4340270f1bcbb0c56fb1.tar.bz2
platform_external_arm-trusted-firmware-46d58f80afc994f522db4340270f1bcbb0c56fb1.zip
Merge pull request #1902 from jts-arm/romlib
ROMLIB bug fixes
Diffstat (limited to 'docs')
-rw-r--r--docs/romlib-design.rst16
1 files changed, 12 insertions, 4 deletions
diff --git a/docs/romlib-design.rst b/docs/romlib-design.rst
index 34a7980be..41957214d 100644
--- a/docs/romlib-design.rst
+++ b/docs/romlib-design.rst
@@ -85,12 +85,12 @@ ROM" to work:
1. ``gentbl.sh`` - Generates the jump table by parsing the index file.
2. ``genvar.sh`` - Generates the jump table global variable (**not** the jump
-table itself) with the absolute address in ROM. This global variable is,
-basically, a pointer to the jump table.
+ table itself) with the absolute address in ROM. This global variable is,
+ basically, a pointer to the jump table.
3. ``genwrappers.sh`` - Generates a wrapper function for each entry in the index
-file except for the ones that contain the keyword ``patch``. The generated
-wrapper file is called ``<lib>_<fn_name>.S``.
+ file except for the ones that contain the keyword ``patch``. The generated
+ wrapper file is called ``<lib>_<fn_name>.S``.
Patching of functions in library at ROM
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -108,6 +108,8 @@ Build library at ROM
~~~~~~~~~~~~~~~~~~~~~
The environment variable ``CROSS_COMPILE`` must be set as per the user guide.
+In the below example the usage of ROMLIB together with mbed TLS is demonstrated
+to showcase the benefits of library at ROM - it's not mandatory.
::
@@ -120,6 +122,12 @@ The environment variable ``CROSS_COMPILE`` must be set as per the user guide.
USE_ROMLIB=1 \
all fip
+Known issue
+-----------
+When building library at ROM, a clean build is always required. This is
+necessary when changes are made to the index files, e.g. adding new functions,
+patching existing ones etc.
+
--------------
*Copyright (c) 2019, Arm Limited. All rights reserved.*