README.commands: Document what UNDEF_SYM does
PATCH 1/1 README.commands: Document what UNDEF_SYM does
--- doc/README.commands | 6 ++++++ 1 file changed, 6 insertions(+)
doc/README.commands +6 -0
@@ -22,6 +22,12 @@ This makes it possible for the final link to extract all commands compiled into any object code and construct a static array so the command can be found in an array starting at __u_boot_cmd_start. +To ensure that the linker does not discard these symbols when linking +full U-Boot we use generate a list of all of the commands and force the +linker to first enter the symbol as undefined in the object so that +there is then a need for the symbol to be kept (UNDEF_SYM in the +Makefile). + If a new board is defined do not forget to define the command section by writing in u-boot.lds ($(TOPDIR)/board/boardname/u-boot.lds) these 3 lines:
Signature · 1 line
1.7.9.5
PATCH 1/1 README.commands: Document what UNDEF_SYM does
doc/README.commands This makes it possible for the final link to extract all commands · line 30
Quoted 6 lines · Tom Rini
doc/README.commands +6
-0+To ensure that the linker does not discard these symbols when linking +full U-Boot we use generate a list of all of the commands and force the +linker to first enter the symbol as undefined in the object so that +there is then a need for the symbol to be kept (UNDEF_SYM in the +Makefile). +
I have no idea what this is about, but my mind has difficulty parsing this sentence.
"To ensure that the linker does not discard these symbols when linking full U-Boot we use generate a list"
a generated list?
Regards,
Jeroen
PATCH 1/1 README.commands: Document what UNDEF_SYM does
Quoted 10 lines · Jeroen Hofstee
doc/README.commands This makes it possible for the final link to extract all commands · line 30
Quoted 6 lines · Tom Rini
doc/README.commands +6
-0+To ensure that the linker does not discard these symbols when linking +full U-Boot we use generate a list of all of the commands and force the +linker to first enter the symbol as undefined in the object so that +there is then a need for the symbol to be kept (UNDEF_SYM in the +Makefile). +I have no idea what this is about, but my mind has difficulty parsing this sentence.
Quoted 4 lines
"To ensure that the linker does not discard these symbols when linking full U-Boot we use generate a list"
a generated list?
Bah, re-wrote the sentance a few times in my head as I was writing it. ... full U-Boot we geneate a list of all the commands we have built (based on the sections mentioned above) and use that to force the linker
...
Signature · 8 lines
Tom -------------- next part -------------- A non-text attachment was scrubbed... Name: not available Type: application/pgp-signature Size: 836 bytes Desc: Digital signature URL: <http://lists.denx.de/pipermail/u-boot/attachments/20120919/e6e15e13/attachment.pgp>