docs/tools/memory-layout-tool.rst

4 TF-A's memory layout tool is a Python script for analyzing the virtual
37 The tool can be used to generate a visualisation of the symbol table. By
107 Because of the length of many of the symbols, the tool defaults to a text width
121 generate a table (per memory type), showing memory allocation and usage. This is
235 The tool provides a by-translation-unit summary of the sizes (``text``, ``bss``,
237 For example, to print a table of an FVP build, with a path depth of 3:
325     | lib/libc.a/assert.o                    |       48(+48) |       0(+0) |         0(+0) |
326     | lib/libc.a/exit.o                      |       64(+64) |       0(+0) |         8(+8) |
327     | lib/libc.a/memchr.o                    |       44(+44) |       0(+0) |         0(+0) |
328     | lib/libc.a/memcmp.o                    |       52(+52) |       0(+0) |         0(+0) |
329     | lib/libc.a/memcpy.o                    |       32(+32) |       0(+0) |         0(+0) |
330     | lib/libc.a/memmove.o                   |       52(+52) |       0(+0) |         0(+0) |
331     | lib/libc.a/memset.o                    |     140(+140) |       0(+0) |         0(+0) |
332     | lib/libc.a/printf.o                    |   1532(+1532) |       0(+0) |         0(+0) |
333     | lib/libc.a/snprintf.o                  |   1748(+1748) |       0(+0) |         0(+0) |
334     | lib/libc.a/strcmp.o                    |       44(+44) |       0(+0) |         0(+0) |
335     | lib/libc.a/strlen.o                    |       28(+28) |       0(+0) |         0(+0) |
336     | lib/libfdt.a/fdt.o                     |   1460(+1460) |       0(+0) |         0(+0) |
337     | lib/libfdt.a/fdt_ro.o                  |   1392(+1392) |       0(+0) |         0(+0) |
338     | lib/libfdt.a/fdt_wip.o                 |     244(+244) |       0(+0) |         0(+0) |
339     | lib/libmbedtls.a/asn1parse.o           |     956(+956) |       0(+0) |         0(+0) |
340     | lib/libmbedtls.a/bignum.o              |   6796(+6796) |       0(+0) |         0(+0) |
341     | lib/libmbedtls.a/bignum_core.o         |   3252(+3252) |       0(+0) |         0(+0) |
342     | lib/libmbedtls.a/constant_time.o       |     280(+280) |       0(+0) |         8(+8) |
343     | lib/libmbedtls.a/md.o                  |     504(+504) |       0(+0) |         0(+0) |
344     | lib/libmbedtls.a/memory_buffer_alloc.o |   1264(+1264) |       0(+0) |       40(+40) |
345     | lib/libmbedtls.a/oid.o                 |     752(+752) |       0(+0) |         0(+0) |
346     | lib/libmbedtls.a/pk.o                  |     872(+872) |       0(+0) |         0(+0) |
347     | lib/libmbedtls.a/pk_wrap.o             |     848(+848) |       0(+0) |         0(+0) |
348     | lib/libmbedtls.a/pkparse.o             |     516(+516) |       0(+0) |         0(+0) |
349     | lib/libmbedtls.a/platform.o            |       92(+92) |     24(+24) |         0(+0) |
350     | lib/libmbedtls.a/platform_util.o       |       96(+96) |       0(+0) |         0(+0) |
351     | lib/libmbedtls.a/rsa.o                 |   6588(+6588) |       0(+0) |         0(+0) |
352     | lib/libmbedtls.a/rsa_alt_helpers.o     |   2340(+2340) |       0(+0) |         0(+0) |
353     | lib/libmbedtls.a/sha256.o              |   1448(+1448) |       0(+0) |         0(+0) |
354     | lib/libmbedtls.a/x509.o                |   1028(+1028) |       0(+0) |         0(+0) |
360 a path to the previous map file.
380 alignments, such as a 4KB page boundary, and excluding that padding can provide
382 yields such a summary: