Tool for analyzing the sizes of symbols in binaries.

It can be used to find out which symbols are taking up the most space in a binary.

It requires bloaty and nm tools to be installed.

It analyzes the .elf file and optionally also the .map file from the binary creation process.

Installable by pip install binsize - see PyPI.

Installing this package creates binsize command, which has a lot of subcommands seeable by binsize --help. For example

$ binsize get firmware.elf -d
$ binsize compare firmware.elf other_firmware.elf
$ binsize tree firmware.elf

--help can be used even on the subcommands, for example binsize get --help - to see all available options.

Result will be usually printed into terminal, unless specifying --output option which some commands support.

To resolve all the files properly, the project's root directory needs to be set correctly.

There are couple of possibilities how to do it.

In the end, all of them are changing the root value in settings.json, from where everything else gets the value. It needs to be an absolute path.

settings.json will be created in a user's home directory, based on platformdirs library (~/.config/binsize/settings.json on linux).

Just modifying the root in the settings.json file.

BINSIZE_ROOT_DIR env variable is checked and when not empty, it will set the root directory.

e.g. BINSIZE_ROOT_DIR=/home/user/project binsize tree /path/to/file.elf

binsize accepts -r / --root-dir argument, which can be used to set the root directory.

It has lower priority than the environmental variable.

e.g. binsize -r /home/user/project tree /path/to/file.elf

binsize exposes set_root_dir function, which can be called from any python script.

e.g. binsize.set_root_dir("/home/user/project")

TODO: document all the CLI commands, exportable symbols, basic functioning, ways to extend it, etc.