llvm-size - print size information
llvm-size [options] [input...]
LLVM-SIZE(1) LLVM LLVM-SIZE(1) NAME llvm-size - print size information SYNOPSIS llvm-size [options] [input...] DESCRIPTION llvm-size is a tool that prints size information for binary files. It is intended to be a drop-in replacement for GNU's size. The tool prints size information for each input specified. If no input is specified, the program prints size information for a.out. If "-" is specified as an input file, llvm-size reads a file from the standard input stream. If an input is an archive, size information will be dis- played for all its members. OPTIONS -A Equivalent to --format with a value of sysv. --arch=<arch> Architecture(s) from Mach-O universal binaries to display infor- mation for. -B Equivalent to --format with a value of berkeley. --common Include ELF common symbol sizes in bss size for berkeley output format, or as a separate section entry for sysv output. If not specified, these symbols are ignored. -d Equivalent to --radix with a value of 10. -l Display verbose address and offset information for segments and sections in Mach-O files in darwin format. --format=<format> Set the output format to the <format> specified. Available <for- mat> options are berkeley (the default), sysv and darwin. Berkeley output summarises text, data and bss sizes in each file, as shown below for a typical pair of ELF files: $ llvm-size --format=berkeley test.o test2.o text data bss dec hex filename 182 16 5 203 cb test.elf 82 8 1 91 5b test2.o For Mach-O files, the output format is slightly different: $ llvm-size --format=berkeley macho.obj macho2.obj __TEXT __DATA __OBJC others dec hex 4 8 0 0 12 c macho.obj 16 32 0 0 48 30 macho2.obj Sysv output displays size and address information for most sec- tions, with each file being listed separately: $ llvm-size --format=sysv test.elf test2.o test.elf : section size addr .eh_frame 92 2097496 .text 90 2101248 .data 16 2105344 .bss 5 2105360 .comment 209 0 Total 412 test2.o : section size addr .text 26 0 .data 8 0 .bss 1 0 .comment 106 0 .note.GNU-stack 0 0 .eh_frame 56 0 .llvm_addrsig 2 0 Total 199 darwin format only affects Mach-O input files. If an input of a different file format is specified, llvm-size falls back to berkeley format. When producing darwin format, the tool displays information about segments and sections: $ llvm-size --format=darwin macho.obj macho2.obj macho.obj: Segment : 12 Section (__TEXT, __text): 4 Section (__DATA, __data): 8 total 12 total 12 macho2.obj: Segment : 48 Section (__TEXT, __text): 16 Section (__DATA, __data): 32 total 48 total 48 --help, -h Display a summary of command line options. --help-list Display an uncategorized summary of command line options. -m Equivalent to --format with a value of darwin. -o Equivalent to --radix with a value of 8. --radix=<value> Display size information in the specified radix. Permitted val- ues are 8, 10 (the default) and 16 for octal, decimal and hexa- decimal output respectively. Example: $ llvm-size --radix=8 test.o text data bss oct hex filename 0152 04 04 162 72 test.o $ llvm-size --radix=10 test.o text data bss dec hex filename 106 4 4 114 72 test.o $ llvm-size --radix=16 test.o text data bss dec hex filename 0x6a 0x4 0x4 114 72 test.o --totals, -t Applies only to berkeley output format. Display the totals for all listed fields, in addition to the individual file listings. Example: $ llvm-size --totals test.elf test2.o text data bss dec hex filename 182 16 5 203 cb test.elf 82 8 1 91 5b test2.o 264 24 6 294 126 (TOTALS) --version Display the version of the llvm-size executable. -x Equivalent to --radix with a value of 16. @<FILE> Read command-line options from response file <FILE>. EXIT STATUS llvm-size exits with a non-zero exit code if there is an error. Other- wise, it exits with code 0. BUGS To report bugs, please visit <https://bugs.llvm.org/>. AUTHOR Maintained by the LLVM Team (https://llvm.org/). COPYRIGHT 2003-2022, LLVM Project ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+---------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+---------------------+ |Availability | developer/llvm/llvm | +---------------+---------------------+ |Stability | Uncommitted | +---------------+---------------------+ NOTES Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from https://github.com/llvm/llvm- project/releases/download/llvmorg-11.0.0/llvm-11.0.0.src.tar.xz. Further information about this software can be found on the open source community website at https://llvm.org/. 11 2022-06-28 LLVM-SIZE(1)