3.4.25 Summary Option

The -msummary=type option selects the type of information that is included in the summary that is displayed once the build is complete. By default, or if the mem type is selected, a memory summary with the total memory usage for all memory spaces is shown.

A psect summary can be shown by enabling the psect type. This shows individual psects after they have been grouped by the linker and the memory ranges they cover. Table 4-20 shows what summary types are available. The default output printed corresponds to the mem setting.

SHA hashes for the generated hex file can also be shown using this option. These can be used to quickly determine if anything in the hex file has changed from a previous build.

Table 3-6. Summary Types
Type Shows
psect A summary of psect names and the addresses where they were linked will be shown.
mem A concise summary of memory used will be shown (default).
class A summary of all classes in each memory space will be shown.
hex A summary of addresses and HEX files that make up the final output file will be shown.
file Summary information will be shown on screen and saved to a file.
sha1 A SHA1 hash for the hex file.
sha256 A SHA256 hash for the hex file.
xml Summary information will be shown on the screen, and usage information for the main memory spaces will be saved in an XML file.
xmlfull Summary information will be shown on the screen, and usage information for all memory spaces will be saved in an XML file.

If specified, the XML files contain information about memory spaces on the selected device, consisting of the space’s name, addressable unit, size, amount used and amount free.